Skip to content
Back to search

dsh-noema

Noema long-term memory plugin for DSH: durable, inspectable agent memory with recall tools and a settings page.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zseven-w--dsh-noema/badge.svg)](/listings/zseven-w--dsh-noema)

HTML

<a href="/listings/zseven-w--dsh-noema"><img src="/api/listings/zseven-w--dsh-noema/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

dsh plugin --profile web add @zseven-w/dsh-noema@latest
dsh web

Or, for local development straight from the source tree:

dsh plugin --profile web add link:/path/to/dsh-noema
dsh web

The `link:` protocol symlinks the profile dependency to this repository, so rebuilds are visible immediately and Cordis HMR can watch the compiled output.

The plugin bundles the `noema-mcp` binary through per-platform optional npm packages. To build it yourself instead, run `cargo build --release -p noema-mcp` inside the bundled `noema` submodule, or point the Server command setting at any `noema-mcp` build.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 211 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src="./docs/images/dsh-noema-logo.png" alt="DSH Noema" width="120" />
  3. </p>
  4. <h1 align="center">DSH Noema</h1>
  5. <p align="center">
  6. <strong>Long-term memory for DeepSeek Harness — durable, inspectable agent memory backed by Noema.</strong><br />
  7. <sub>Recall Before Work &bull; Import From 9 Agent Tools &bull; Settings-Page Memory Management &bull; Crash Keep-Alive &bull; Hot Reload</sub>
  8. </p>
  9. <p align="center">
  10. <sub>npm: <a href="https://www.npmjs.com/package/@zseven-w/dsh-noema"><code>@zseven-w/dsh-noema</code></a> · Tested with DSH <code>0.2.0-rc.2</code></sub>
  11. </p>
  12. <p align="center">
  13. <a href="./README.md"><b>English</b></a> · <a href="./README.zh.md">简体中文</a> · <a href="./README.zh-TW.md">繁體中文</a> · <a href="./README.ja.md">日本語</a> · <a href="./README.ko.md">한국어</a> · <a href="./README.fr.md">Français</a> · <a href="./README.es.md">Español</a> · <a href="./README.de.md">Deutsch</a> · <a href="./README.pt.md">Português</a> · <a href="./README.ru.md">Русский</a> · <a href="./README.hi.md">हिन्दी</a> · <a href="./README.tr.md">Türkçe</a> · <a href="./README.th.md">ไทย</a> · <a href="./README.vi.md">Tiếng Việt</a> · <a href="./README.id.md">Bahasa Indonesia</a>
  14. </p>
  15. <p align="center">
  16. <a href="https://www.npmjs.com/package/@zseven-w/dsh-noema"><img src="https://img.shields.io/npm/v/%40zseven-w%2Fdsh-noema?style=flat&color=cfb537" alt="npm" /></a>
  17. <a href="https://github.com/ZSeven-W/dsh-noema/stargazers"><img src="https://img.shields.io/github/stars/ZSeven-W/dsh-noema?style=flat&color=cfb537" alt="Stars" /></a>
  18. <a href="https://github.com/ZSeven-W/dsh-noema/blob/main/LICENSE"><img src="https://img.shields.io/github/license/ZSeven-W/dsh-noema?color=64748b" alt="License" /></a>
  19. </p>
  20. <br />
  21. <p align="center">
  22. <img src="./docs/images/dsh-noema-overview.png" alt="DSH Noema — memory settings page" width="100%" />
  23. </p>
  24. <p align="center"><sub>The Noema Memory settings page — import sources, memory management, and live server status</sub></p>
  25. ## Why DSH Noema
  26. DSH Noema connects [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) with [Noema](https://github.com/ZSeven-W/noema) — a local-first, non-vector memory system for coding agents — so an Agent keeps durable knowledge across sessions instead of starting every conversation from zero.
  27. <table>
  28. <tr>
  29. <td width="50%">
  30. ### 🧠 Durable Recall
  31. Memories persist as inspectable Markdown files under `NOEMA_ROOT` (default `~/.agent-memory/`). `noema_recall` loads relevant context at the start of a session; `noema_search`, `noema_browse`, `noema_catalog`, and `noema_recall_graph` cover lookup, exploration, and auditing.
  32. </td>
  33. <td width="50%">
  34. ### 📥 Import From Other Tools
  35. `noema_import` reads the memory files of ten other AI coding tools — Codex, Claude Code, opencode, Cursor, Grok, WorkBuddy, Antigravity, Trae, Qoder, Hermes — splits them into sections, and saves each as a durable memory. A content-keyed ledger deduplicates across runs and across tools that share files.
  36. </td>
  37. </tr>
  38. <tr>
  39. <td width="50%">
  40. ### 🛠️ Settings-Page Management
  41. The Noema Memory settings page configures the server command, memory root, budgets, idle/call timeouts, and the guidance section — and a Manage memories card searches, browses, adds, reviews, and deletes stored memories directly.
  42. </td>
  43. <td width="50%">
  44. ### 🩺 Keep-Alive
  45. The memory server stays up: idle timeout defaults to never, and a keep-alive loop restarts the `noema-mcp` child in the background when it crashes or exits, with a configurable check interval and restart backoff.
  46. </td>
  47. </tr>
  48. <tr>
  49. <td width="50%">
  50. ### 🔍 Smart Entity Extraction
  51. Noema's extraction engine combines jieba word segmentation with high-precision signals — English proper nouns, CJK names and technical terms, quoted topics, and repetition — with stopword and path filters, so the PageIndex topic catalog stays clean.
  52. </td>
  53. <td width="50%">
  54. ### ⚡ Hot Reload
  55. After the first boot, the plugin never needs a restart again: `pnpm run build` hot-reloads the host plugin through Cordis HMR, and `ppnpm run build:client` hot-swaps the browser bundle over the client-hmr SSE channel.
  56. </td>
  57. </tr>
  58. </table>
  59. ## Install into DSH
  60. ```sh
  61. dsh plugin --profile web add @zseven-w/dsh-noema@latest
  62. dsh web
  63. ```
  64. Or, for local development straight from the source tree:
  65. ```sh
  66. dsh plugin --profile web add link:/path/to/dsh-noema
  67. dsh web
  68. ```
  69. The `link:` protocol symlinks the profile dependency to this repository, so rebuilds are visible immediately and Cordis HMR can watch the compiled output.
  70. The plugin bundles the `noema-mcp` binary through per-platform optional npm packages. To build it yourself instead, run `cargo build --release -p noema-mcp` inside the bundled `noema` submodule, or point the Server command setting at any `noema-mcp` build.
  71. ## Memory Tools
  72. The model-facing tools mirror the Noema MCP surface:
  73. | Tool | What it does |
  74. | --- | --- |
  75. | `noema_recall` | Recall relevant memories for a query, with a token budget. |
  76. | `noema_search` | Full-text search over stored memories. |
  77. | `noema_browse` | Browse the PageIndex catalog for a topic or entity. |
  78. | `noema_catalog` | Render the full memory catalog as markdown. |
  79. | `noema_recall_graph` | Multi-hop recall through links and shared entities. |
  80. | `noema_neighbors` | One graph hop from a memory. |
  81. | `noema_explain` | Explain why a memory was or was not recalled. |
  82. | `noema_remember` | Save a durable fact, decision, constraint, or preference. |
  83. | `noema_review_list` | List pending review candidates. |
  84. | `noema_review_decide` | Accept, reject, edit, or merge a candidate. |
  85. | `noema_forget` | Tombstone or hard-delete a memory. |
  86. | `noema_policy_get` / `noema_policy_set` | Read or update the write policy. |
  87. | `noema_status` | Server and tenant status: counts, index health, storage root. |
  88. | `noema_import` | Import memories from other AI coding tools. |
  89. Each tool returns a uniform envelope `{ ok, tool, text }` where `text` carries the full server output.
  90. ## Import memories from other tools
  91. | Source id | Global files | Workspace files |
  92. | --- | --- | --- |
  93. | `codex` | `~/.codex/AGENTS.md` + the Codex memory pipeline: `~/.codex/memories/MEMORY.md`, `memory_summary.md`, `rollout_summaries/*.md`, `extensions/ad_hoc/notes/*.md` (`raw_memories.md` skipped — it is the uncurated feed) | `AGENTS.md`, `AGENTS.local.md` |
  94. | `claude-code` | `~/.claude/CLAUDE.md`, `~/.claude/CLAUDE.local.md`, `~/.claude/MEMORY.md` | `CLAUDE.md`, `CLAUDE.local.md`, `MEMORY.md` |
  95. | `opencode` | `~/.config/opencode/AGENTS.md` | `AGENTS.md` |
  96. | `cursor` | `~/.cursor/rules/*.mdc`, `~/.cursorrules` | `.cursor/rules/*.mdc`, `.cursorrules` |
  97. | `grok` | `~/.grok/AGENTS.md` + the Grok cross-session memory: `~/.grok/memory/MEMORY.md`, per-project `MEMORY.md`, and `sessions/*.md` summaries | `AGENTS.md` |
  98. | `workbuddy` | `~/.codebuddy/CODEBUDDY.md` (WorkBuddy memory file), `~/.workbuddy/AGENTS.md`, `~/.workbuddy/memory.md`, `~/.config/workbuddy/AGENTS.md`, `~/Library/Application Support/WorkBuddy/AGENTS.md` | `AGENTS.md`, `CODEBUDDY.md` |
  99. | `antigravity` | `~/.antigravity/AGENTS.md`, `~/.config/antigravity/AGENTS.md`, `~/Library/Application Support/Antigravity/AGENTS.md` (best-effort; no documented global memory store yet) | `AGENTS.md`, `AGENTS.local.md` |
  100. | `trae` | `~/.trae/AGENTS.md`, `~/.trae/memory/`, `~/.trae/rules/` (plus the `~/.trae-cn` variants) | `AGENTS.md`, `.trae/rules/` |
  101. | `qoder` | `~/.qoder-cn/AGENTS.md`, `~/.qoder-cn/rules/`, the auto-memory roots `~/.qoder-cn/memory/` and `~/.qoder-cn/projects/*/memory/` (plus `~/.qoder` variants) | `AGENTS.md`, `AGENTS.local.md`, `.qoder/rules/` |
  102. | `hermes` | `~/.hermes/memories/` (`MEMORY.md` + `USER.md`) and the global `~/.hermes/SOUL.md` | `.hermes.md`, `HERMES.md`, `AGENTS.md`, `CLAUDE.md` |
  103. - The `source` argument selects one tool, or omit it to run every source enabled in settings.
  104. - The `path` argument selects the workspace root for project-scoped files (defaults to the session workspace; workspace files only load when the Import workspace files setting is on).
  105. - Imports are deduplicated through a ledger at `$DSH_HOME/storages/dsh-noema-imports.json`, keyed by file path + section content — when several tools share one project `AGENTS.md`, each section is imported exactly once. `force: true` re-imports everything.
  106. - The settings page exposes per-source checkboxes, an import-on-startup toggle, a file-size cap, and an Import now button with a last-run summary.
  107. ## Settings
  108. Open **Settings → Noema Memory**:
  109. | Setting | Default | Meaning |
  110. | --- | --- | --- |
  111. | Enable memory | on | Master switch for the `noema_*` tools. |
  112. | Memory guidance | on | System-prompt section teaching memory usage. |
  113. | Start server at boot | on | Spawn at DSH start instead of first use. |
  114. | Auto-accept new memories | on | `noema_remember` persists immediately. |
  115. | Server command | `bundled` | Bundled `noema-mcp` binary or a custom executable path/command. |
  116. | Working directory | — | cwd for the server (needed for `cargo run`). |
  117. | Memory root (NOEMA_ROOT) | — | Where memories are stored; empty = `~/.agent-memory`. |
  118. | Recall token budget | 1200 | Default `budget_tokens` for `noema_recall`. |
  119. | Idle timeout (ms) | 0 | Stop the server after idle; 0 = never. |
  120. | Keep alive | on | Restart the server in the background when it crashes or exits. |
  121. | Keep-alive interval (ms) | 5000 | Minimum delay between background health checks. |
  122. | Call timeout (ms) | 30000 | Per-tool-call deadline. |
  123. | Restart delay (ms) | 1000 | Backoff between a stop/crash and the next start. |
  124. The status card shows server health with restart/stop actions, and the import section manages the nine memory sources.
  125. ## Hot reload
  126. DSH's HMR machinery is fully usable once the plugin has been loaded once:
  127. - **Host plugin** — enable the Cordis HMR entry in the profile patch with its watch root pointed at this package's `lib/` output, and keep the `link:` dependency. Run `pnpm run build` and the running DSH reloads the plugin entry automatically (the Noema server child is restarted by the reload) — no server restart.
  128. ```yaml
  129. # ~/.dsh/profiles/<profile>/cordis.patch.yml
  130. - id: hmr
  131. disabled: false
  132. config:
  133. root:
  134. - /path/to/dsh-noema/lib
  135. ```
  136. - **Client bundle** — `ppnpm run build:client` rewrites `lib/client.js`; the client-hmr node half stat-polls every graph bundle (default 500ms) and broadcasts a `rebuilt` frame over the `/plugins/events` SSE channel, and the browser hot-swaps the module without a page refresh.
  137. - **Settings** — every change made on the Noema Memory settings page applies live through the settings service.
  138. The one thing hot-reload cannot do is load a plugin that was never in the booted tree: the running composition neither watches the profile patch layer (the web app does not wire `watchUserPatches`) nor exposes a loader mutation API (the plugin inventory RPC is read-only). A fresh plugin therefore needs exactly one server restart, after which the loop above is fully hot.
  139. ## Develop
  140. ```sh
  141. pnpm install
  142. pnpm run build # host tsc + client tsdown bundle
  143. pnpm test # build + node --test tests/
  144. ```
  145. The e2e test runs against `noema/target/debug/noema-mcp` when present (it is skipped otherwise).
  146. ## Ecosystem
  147. - [DSH Android](https://github.com/ZSeven-W/dsh-android) — a live Android emulator or USB device inside the conversation, driven entirely through adb
  148. - [DSH Crew](https://github.com/ZSeven-W/dsh-crew) — dispatch work to DSH agents from Claude Code / Codex
  149. - [DSH iOS](https://github.com/ZSeven-W/dsh-ios) — a live iOS Simulator and a USB-connected iPhone, inside the conversation
  150. - [DSH OpenPencil](https://github.com/ZSeven-W/dsh-openpencil) — inspect and edit `.op` design documents inside a conversation
  151. ## License
  152. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.