memorix 1.4.3 → 1.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (158) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/README.md +20 -6
  3. package/README.zh-CN.md +16 -3
  4. package/TEAM.md +86 -86
  5. package/assets/star-history-dark.svg +8 -8
  6. package/assets/star-history-light.svg +8 -8
  7. package/assets/star-history.json +16 -2
  8. package/dist/cli/index.js +539 -233
  9. package/dist/cli/memcode.js +0 -0
  10. package/dist/index.js +72 -15
  11. package/dist/maintenance-runner.js +9 -7
  12. package/dist/media-audio-runner.js +9 -7
  13. package/dist/media-video-runner.js +9 -7
  14. package/dist/memcode/index.js +9 -7
  15. package/dist/memcode-runtime/CHANGELOG.md +34 -0
  16. package/dist/sdk.js +71 -14
  17. package/dist/types.d.ts +1 -1
  18. package/dist/vector-backfill-runner.js +9 -7
  19. package/docs/AGENT_OPERATOR_PLAYBOOK.md +6 -5
  20. package/docs/API_REFERENCE.md +9 -5
  21. package/docs/CONFIGURATION.md +15 -5
  22. package/docs/DESIGN_DECISIONS.md +357 -357
  23. package/docs/DEVELOPMENT.md +2 -2
  24. package/docs/INTEGRATIONS.md +9 -2
  25. package/docs/KNOWN_ISSUES_AND_ROADMAP.md +4 -3
  26. package/docs/MEMCODE.md +1 -1
  27. package/docs/MODULES.md +1 -1
  28. package/docs/README.md +1 -1
  29. package/docs/SETUP.md +12 -4
  30. package/docs/hooks-architecture.md +2 -1
  31. package/llms-full.txt +7 -6
  32. package/llms.txt +2 -2
  33. package/package.json +1 -1
  34. package/plugins/claude/memorix/.claude-plugin/plugin.json +1 -1
  35. package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json +1 -1
  36. package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
  37. package/plugins/copilot/memorix/plugin.json +1 -1
  38. package/plugins/gemini/memorix/gemini-extension.json +1 -1
  39. package/plugins/omp/memorix/package.json +1 -1
  40. package/plugins/openclaw/memorix/.codex-plugin/plugin.json +1 -1
  41. package/plugins/pi/memorix/package.json +1 -1
  42. package/server.json +2 -2
  43. package/src/audit/index.ts +156 -156
  44. package/src/cli/commands/agent-integrations.ts +7 -1
  45. package/src/cli/commands/audit-list.ts +89 -89
  46. package/src/cli/commands/formation.ts +48 -48
  47. package/src/cli/commands/git-hook-install.ts +111 -111
  48. package/src/cli/commands/handoff.ts +54 -54
  49. package/src/cli/commands/hooks-install.ts +2 -0
  50. package/src/cli/commands/hooks-preview.ts +5 -0
  51. package/src/cli/commands/hooks-status.ts +63 -63
  52. package/src/cli/commands/ingest.ts +44 -44
  53. package/src/cli/commands/integrate-shared.ts +15 -15
  54. package/src/cli/commands/integrate.ts +2 -0
  55. package/src/cli/commands/lock.ts +82 -82
  56. package/src/cli/commands/media-image.ts +27 -0
  57. package/src/cli/commands/media.ts +8 -1
  58. package/src/cli/commands/memory.ts +44 -34
  59. package/src/cli/commands/message.ts +104 -104
  60. package/src/cli/commands/operator-shared.ts +62 -18
  61. package/src/cli/commands/poll.ts +58 -58
  62. package/src/cli/commands/purge-all-memory.ts +85 -85
  63. package/src/cli/commands/purge-project-memory.ts +83 -83
  64. package/src/cli/commands/reasoning.ts +118 -118
  65. package/src/cli/commands/setup.ts +57 -2
  66. package/src/cli/commands/skills.ts +114 -114
  67. package/src/cli/commands/task.ts +167 -167
  68. package/src/cli/commands/transfer.ts +47 -47
  69. package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
  70. package/src/cli/commands/uninstall.ts +20 -0
  71. package/src/cli/tui/ChatView.tsx +234 -234
  72. package/src/cli/tui/CommandBar.tsx +312 -312
  73. package/src/cli/tui/ContextRail.tsx +118 -118
  74. package/src/cli/tui/HeaderBar.tsx +72 -72
  75. package/src/cli/tui/LogoBanner.tsx +51 -51
  76. package/src/cli/tui/Sidebar.tsx +179 -179
  77. package/src/cli/tui/index.ts +41 -41
  78. package/src/cli/tui/markdown-render.tsx +371 -371
  79. package/src/cli/tui/use-mouse.ts +157 -157
  80. package/src/cli/tui/useNavigation.ts +56 -56
  81. package/src/cli/version.ts +7 -7
  82. package/src/cli/workbench.ts +1 -1
  83. package/src/dashboard/project-classification.ts +64 -64
  84. package/src/git/hooks-path.ts +85 -85
  85. package/src/hooks/installers/index.ts +43 -2
  86. package/src/hooks/pattern-detector.ts +173 -173
  87. package/src/hooks/significance-filter.ts +250 -250
  88. package/src/hooks/types.ts +2 -0
  89. package/src/integrations/registry.ts +9 -0
  90. package/src/llm/memory-manager.ts +328 -328
  91. package/src/llm/provider.ts +885 -885
  92. package/src/llm/quality.ts +248 -248
  93. package/src/media/minimax.ts +9 -1
  94. package/src/memory/attribution-guard.ts +249 -249
  95. package/src/memory/disclosure-policy.ts +135 -135
  96. package/src/memory/entity-extractor.ts +197 -197
  97. package/src/memory/formation/evaluate.ts +217 -217
  98. package/src/memory/formation/extract.ts +361 -361
  99. package/src/memory/formation/index.ts +417 -417
  100. package/src/memory/formation/resolve.ts +344 -344
  101. package/src/memory/formation/types.ts +315 -315
  102. package/src/memory/freshness.ts +122 -122
  103. package/src/memory/graph.ts +197 -197
  104. package/src/memory/refs.ts +94 -94
  105. package/src/memory/secret-filter.ts +79 -79
  106. package/src/orchestrate/adapters/claude-stream.ts +192 -192
  107. package/src/orchestrate/adapters/claude.ts +111 -111
  108. package/src/orchestrate/adapters/codex-stream.ts +134 -134
  109. package/src/orchestrate/adapters/codex.ts +41 -41
  110. package/src/orchestrate/adapters/gemini-stream.ts +166 -166
  111. package/src/orchestrate/adapters/gemini.ts +42 -42
  112. package/src/orchestrate/adapters/index.ts +73 -73
  113. package/src/orchestrate/adapters/opencode-stream.ts +143 -143
  114. package/src/orchestrate/adapters/opencode.ts +47 -47
  115. package/src/orchestrate/adapters/types.ts +77 -77
  116. package/src/orchestrate/capability-router.ts +284 -284
  117. package/src/orchestrate/context-compact.ts +188 -188
  118. package/src/orchestrate/cost-tracker.ts +219 -219
  119. package/src/orchestrate/error-recovery.ts +191 -191
  120. package/src/orchestrate/evidence.ts +140 -140
  121. package/src/orchestrate/ledger.ts +110 -110
  122. package/src/orchestrate/memorix-bridge.ts +343 -343
  123. package/src/orchestrate/output-budget.ts +80 -80
  124. package/src/orchestrate/permission.ts +152 -152
  125. package/src/orchestrate/pipeline-trace.ts +131 -131
  126. package/src/orchestrate/prompt-builder.ts +155 -155
  127. package/src/orchestrate/ring-buffer.ts +37 -37
  128. package/src/orchestrate/task-graph.ts +389 -389
  129. package/src/project/aliases.ts +374 -374
  130. package/src/rules/adapters/trae.ts +56 -56
  131. package/src/rules/syncer.ts +235 -235
  132. package/src/search/query-expansion.ts +52 -52
  133. package/src/server/formation-timeout.ts +27 -27
  134. package/src/server.ts +23 -1
  135. package/src/skills/mini-skills.ts +386 -386
  136. package/src/store/chat-store.ts +119 -119
  137. package/src/store/graph-store.ts +249 -249
  138. package/src/store/mini-skill-store.ts +349 -349
  139. package/src/store/persistence-json.ts +212 -212
  140. package/src/store/persistence.ts +291 -291
  141. package/src/store/project-affinity.ts +195 -195
  142. package/src/team/event-bus.ts +76 -76
  143. package/src/team/file-locks.ts +173 -173
  144. package/src/team/handoff.ts +161 -161
  145. package/src/team/messages.ts +203 -203
  146. package/src/team/poll.ts +132 -132
  147. package/src/team/tasks.ts +211 -211
  148. package/src/types.ts +1 -1
  149. package/src/workspace/mcp-adapters/codex.ts +191 -191
  150. package/src/workspace/mcp-adapters/copilot.ts +105 -105
  151. package/src/workspace/mcp-adapters/cursor.ts +53 -53
  152. package/src/workspace/mcp-adapters/dsh.ts +147 -0
  153. package/src/workspace/mcp-adapters/kiro.ts +64 -64
  154. package/src/workspace/mcp-adapters/opencode.ts +123 -123
  155. package/src/workspace/mcp-adapters/trae.ts +134 -134
  156. package/src/workspace/mcp-adapters/windsurf.ts +91 -91
  157. package/src/workspace/sanitizer.ts +60 -60
  158. package/dist/memcode-runtime/docs/images/exy.png +0 -0
@@ -13,9 +13,9 @@ Memorix is a TypeScript project built around:
13
13
 
14
14
  ## Current Development Baseline
15
15
 
16
- The current release work targets the **1.3 line** while package metadata may still show the last published version until the release commit is cut.
16
+ The current release work targets the **1.4 line** while package metadata may still show the last published version until the release commit is cut.
17
17
 
18
- Contributors should assume the following areas are part of the 1.3 release line:
18
+ Contributors should assume the following areas are part of the 1.4 release line:
19
19
 
20
20
  - shared memory across MCP clients, CLI, SDK, dashboard, hooks, and memcode
21
21
  - memcode uses Memorix project memory, hooks, `/memory` commands, resumable sessions, and model switching as the bundled terminal agent
@@ -20,7 +20,7 @@ That command installs the recommended Memorix package or config for the target a
20
20
  | Package or extension | Bundles Memorix for agents that use package or extension systems | `memorix setup --agent pi --global`, `omp --global`, or `gemini-cli --global` |
21
21
  | Local plugin | Installs a local plugin file where the agent loads plugins directly | `memorix setup --agent opencode --global` |
22
22
  | MCP server | Gives an agent live tools for search, recall, storage, reasoning, and coordination | bundled by setup, host MCP config, or `memorix serve` |
23
- | Usage guidance | Tells the agent when and how to use memory | `CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, Cursor/Windsurf/Kiro/Trae rules |
23
+ | Usage guidance | Tells the agent when and how to use memory | `CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, Cursor/Windsurf/Kiro/Trae rules, DeepSeek Harness AGENTS.md |
24
24
  | Hooks | Captures useful session events when the agent exposes hook events | bundled by plugin packages or generated hook files |
25
25
  | Skills | Turns durable project knowledge into reusable task guidance | plugin skills, `memorix skills`, `memorix_promote` |
26
26
  | memcode | Opens a terminal coding agent that already uses Memorix memory | `memorix`, `memcode` |
@@ -36,7 +36,7 @@ CLI, MCP, and HTTP have separate jobs:
36
36
 
37
37
  Generated guidance also has scope:
38
38
 
39
- - Project guidance (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, Cursor/Windsurf/Kiro/Trae rules) may say the repository is configured for Memorix.
39
+ - Project guidance (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, Cursor/Windsurf/Kiro/Trae rules, DeepSeek Harness AGENTS.md) may say the repository is configured for Memorix.
40
40
  - Plugin or skill package guidance is workspace-safe. It says to use Memorix when the active workspace has Memorix tools available.
41
41
  - `--global` writes user-level plugin, config, and hook surfaces where the host supports them.
42
42
  - Running the same setup command without `--global` is the repo-local path for one project only.
@@ -63,6 +63,7 @@ Generated guidance also has scope:
63
63
  | Kiro | `memorix setup --agent kiro --global` | Kiro MCP/steering/hooks config | MCP config, `.kiro/steering/memorix.md`, `.kiro/hooks/*.kiro.hook` | Uses Kiro steering and hook files. |
64
64
  | Antigravity | `memorix setup --agent antigravity --global` | Antigravity plugin | Plugin under `~/.gemini/config/plugins/memorix` or `.agents/plugins/memorix`, with `plugin.json`, `mcp_config.json`, `hooks.json`, rules, and skills | Uses Antigravity's official plugin layout. Dedicated MCP configs live at `~/.gemini/config/mcp_config.json` or `.agents/mcp_config.json`; legacy Gemini settings are read only for compatibility. |
65
65
  | Trae | `memorix setup --agent trae --global` | Trae MCP/rules config | MCP config and `.trae/rules/project_rules.md` | Current support is MCP plus project rules. |
66
+ | DeepSeek Harness | `memorix setup --agent dsh --global` | DeepSeek Harness MCP patch | Memorix `@deepseek-ai/dsh-mcp-client` row in `$DSH_HOME/cordis.patch.yml` (default `~/.dsh/cordis.patch.yml`), guidance in the harness `AGENTS.md`, and official skills under `$DSH_HOME/skills` | Tools appear as `mcp__memorix__*`. No hooks surface. Project-local setup writes project `AGENTS.md` guidance and `.dsh/skills`; the MCP row always lives in the harness-level patch file. |
66
67
  | memcode | `memorix` or `memcode` | Bundled terminal agent | Built-in Memorix memory access | memcode uses the same project memory pool; it is not a separate memory silo. |
67
68
  | Any MCP client | Manual MCP config | MCP stdio or HTTP | `memorix serve` or `memorix background start` | Use stdio first unless you need a shared HTTP endpoint. |
68
69
 
@@ -87,9 +88,15 @@ memorix setup --agent cursor --global
87
88
  memorix setup --agent pi --global
88
89
  memorix setup --agent gemini-cli --global
89
90
  memorix setup --agent opencode --global
91
+ memorix setup --agent windsurf --global
92
+ memorix setup --agent kiro --global
93
+ memorix setup --agent antigravity --global
94
+ memorix setup --agent trae --global
90
95
  memorix setup --agent openclaw --global
91
96
  memorix setup --agent hermes --global
97
+ memorix setup --agent codebuddy --global
92
98
  memorix setup --agent omp --global
99
+ memorix setup --agent dsh --global
93
100
  ```
94
101
 
95
102
  Use `memorix setup --agent all --global` only when you intentionally want every supported agent integration generated for the current machine/user scope.
@@ -1,6 +1,6 @@
1
1
  # Memorix 已知边界与路线图
2
2
 
3
- > 最后审阅:2026-08-03(对照 v1.4.0)
3
+ > 最后审阅:2026-08-14(对照 v1.4.3)
4
4
 
5
5
  这份文档说明仍然成立的产品边界、风险和方向;它不是发布流水账。
6
6
 
@@ -32,7 +32,7 @@ Memorix 是本地优先、可插拔的 Agent Memory 系统。它给不同 Agent
32
32
  |---|---|---|
33
33
  | 项目绑定 | 没有可靠工作区根目录时,MCP 会等待显式根目录、MCP Roots 或会话启动,而不会猜测上一个项目。 | 这是防止跨项目读写的安全边界;首次接入时按客户端的项目根目录配置即可。 |
34
34
  | 向量与外部模型 | 可选嵌入提供商、网络和首次模型准备会影响写入或检索延迟。 | 不要把外部 API 的瞬时可用性当作本地数据是否已写入的唯一判断;先用 `memorix status` / `doctor` 看状态。 |
35
- | 媒体记忆 | 已有受控附件和元数据/向量基础,但 PDF 文本提取、音频转写、视频语义提取仍不是默认的全自动链路。 | 只导入确实需要长期复用的资产;不要把截图或工具输出当作默认记忆来源。 |
35
+ | 媒体记忆 | 已有受控附件和元数据/向量基础,PDF 文本提取与音频转写是显式的受控派生链路;视频语义提取仍不是默认的全自动链路。 | 只导入确实需要长期复用的资产;不要把截图或工具输出当作默认记忆来源。 |
36
36
  | 图谱与 Wiki | 它们是从规范记忆和代码状态生成的可追溯投影,不是可任意编辑的 GraphRAG 数据库。 | 先写清楚有来源的知识和决策,让投影自然形成关联;不要把图谱当作另一份手工真相。 |
37
37
  | Agent 集成 | 上游客户端会改变 hook、MCP、配置文件和权限模型。 | 使用 `memorix doctor agents` 诊断,优先让 `setup` / `repair` 做非破坏性修复。 |
38
38
  | 大规模数据 | 保留、归档、去重和检索预算已存在,但上万至百万级数据仍需要按项目负载做容量验证。 | 为高增长项目配置明确的保留与清理策略,并关注 Dashboard / CLI 的审计信息。 |
@@ -55,7 +55,7 @@ Memorix 是本地优先、可插拔的 Agent Memory 系统。它给不同 Agent
55
55
 
56
56
  ### 3. 受控的多模态派生能力
57
57
 
58
- - 在现有资产生命周期之上评估 PDF 文本提取、音频转写、视频语义派生;
58
+ - 继续在现有资产生命周期之上评估视频语义派生,保持与 PDF/音频派生相同的来源、成本边界、配额、删除联动和重建路径;
59
59
  - 每一类派生都必须有来源、成本边界、配额、删除联动和重建路径;
60
60
  - 不把“接受任意 URL / 任意文件”误宣传为完整多模态 RAG。
61
61
 
@@ -63,6 +63,7 @@ Memorix 是本地优先、可插拔的 Agent Memory 系统。它给不同 Agent
63
63
 
64
64
  - 跟进受用户需求推动的集成,例如 [Qwen 自动 hooks](https://github.com/AVIDS2/memorix/issues/3) 与 [持久化 Agent 身份](https://github.com/AVIDS2/memorix/issues/49);
65
65
  - 独立推进记忆能力的实证研究,例如[模型能力如何改变项目记忆收益与伤害边界](https://github.com/AVIDS2/memorix/issues/152),不把研究假设当作产品已经证明的效果。
66
+ - DeepSeek Harness 支持已随 `memorix setup --agent dsh` 发布:写入 MCP 行(`$DSH_HOME/cordis.patch.yml`,默认 `~/.dsh/cordis.patch.yml`)、AGENTS.md 使用规范与官方 skills;工具以 `mcp__memorix__*` 形式出现。
66
67
 
67
68
  ---
68
69
 
package/docs/MEMCODE.md CHANGED
@@ -224,7 +224,7 @@ memcode update self
224
224
 
225
225
  Memorix is the shared memory layer. memcode is the bundled terminal agent built on top of it.
226
226
 
227
- Use Memorix when you want Claude Code, Codex, Cursor, Windsurf, Copilot, Gemini CLI, OpenCode, OpenClaw, Hermes Agent, Oh-my-Pi, Kiro, Antigravity, Trae, or another MCP client to share project memory.
227
+ Use Memorix when you want Claude Code, Codex, Cursor, Windsurf, Copilot, Gemini CLI, OpenCode, OpenClaw, Hermes Agent, Oh-my-Pi, Kiro, Antigravity, Trae, DeepSeek Harness, or another MCP client to share project memory.
228
228
 
229
229
  Use memcode when you want a terminal agent that already uses that memory layer.
230
230
 
package/docs/MODULES.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Memorix 模块详解
2
2
 
3
- > 最后更新: 2026-07-30 (v1.3.0)
3
+ > 最后更新: 2026-08-14 (v1.4.3)
4
4
  > 本文档详细记录每个模块的实现细节、关键算法和注意事项
5
5
 
6
6
  > 本文档中的早期 JSON/Orama 章节保留为历史模块说明。当前运行时的
package/docs/README.md CHANGED
@@ -117,7 +117,7 @@ Historical/deep-reference documents may describe older designs. If they conflict
117
117
 
118
118
  ## Current Product Line
119
119
 
120
- The released product is on the **1.3 line**. The current baseline has:
120
+ The released product is on the **1.4 line**. The current baseline has:
121
121
 
122
122
  - `memorix setup --agent <agent> --global` is the default agent integration command
123
123
  - `memorix serve` is the manual stdio MCP server for external agents
package/docs/SETUP.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  Memorix is a local-first shared memory layer for AI coding agents.
4
4
 
5
- In the 1.1 line, the normal path is:
5
+ In the current release line, the normal path is:
6
6
 
7
7
  ```bash
8
8
  npm install -g memorix
@@ -68,9 +68,15 @@ memorix setup --agent cursor --global
68
68
  memorix setup --agent pi --global
69
69
  memorix setup --agent gemini-cli --global
70
70
  memorix setup --agent opencode --global
71
+ memorix setup --agent windsurf --global
72
+ memorix setup --agent kiro --global
73
+ memorix setup --agent antigravity --global
74
+ memorix setup --agent trae --global
71
75
  memorix setup --agent openclaw --global
72
76
  memorix setup --agent hermes --global
77
+ memorix setup --agent codebuddy --global
73
78
  memorix setup --agent omp --global
79
+ memorix setup --agent dsh --global
74
80
  ```
75
81
 
76
82
  What this does:
@@ -86,6 +92,7 @@ What this does:
86
92
  - OpenClaw: installs `~/.openclaw/extensions/memorix` as an OpenClaw-compatible bundle with bundled stdio MCP, skills, and an OpenClaw `HOOK.md`/`handler.ts` hook pack.
87
93
  - Hermes Agent: installs into Hermes home (`%LOCALAPPDATA%\hermes` on native Windows, `~/.hermes` elsewhere, or `HERMES_HOME`), enables it in `config.yaml`, registers plugin hooks, a slash command, a CLI command, skills, and writes MCP config in `mcp_servers`.
88
94
  - Oh-my-Pi: installs an `omp.extensions` package, links it with `omp plugin link <path>` when available, and writes `.omp/mcp.json` or `~/.omp/agent/mcp.json` for MCP.
95
+ - DeepSeek Harness: writes a Memorix `@deepseek-ai/dsh-mcp-client` row into `$DSH_HOME/cordis.patch.yml` (default `~/.dsh/cordis.patch.yml`), appends guidance to the harness `AGENTS.md` (`$DSH_HOME/AGENTS.md`, default `~/.dsh/AGENTS.md`), and installs official skills under `$DSH_HOME/skills` (default `~/.dsh/skills`). Tools appear as `mcp__memorix__*`; there is no hooks surface. Project-local setup (without `--global`) appends guidance to the project-root `AGENTS.md` and installs skills under `.dsh/skills`, while the MCP row still goes to the harness-level patch file.
89
96
  - Other supported agents: writes their MCP/rules/hooks files according to agent support.
90
97
 
91
98
  Global setup writes user-level plugin, config, and hook files where the host supports them. Use the same command without `--global` only when you explicitly want repo-local guidance, rules, or hooks for the current project.
@@ -117,7 +124,7 @@ memorix doctor agents --agent <agent>
117
124
  memorix setup --agent <agent> --global
118
125
  ```
119
126
 
120
- Use this for Claude Code, Codex, Cursor, Windsurf, Copilot, Gemini CLI, OpenCode, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Kiro, Antigravity, Trae, or any supported agent. It is the default user-facing install path.
127
+ Use this for Claude Code, Codex, Cursor, Windsurf, Copilot, Gemini CLI, OpenCode, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Kiro, Antigravity, Trae, DeepSeek Harness, or any supported agent. It is the default user-facing install path.
121
128
 
122
129
  To see the current setup matrix:
123
130
 
@@ -144,7 +151,7 @@ memorix serve
144
151
 
145
152
  Use this when your agent only needs a raw local stdio MCP process or you are debugging a manual config. The agent starts `memorix serve` and communicates with it over stdio.
146
153
 
147
- The stdio server defaults to `--mode micro`, which exposes 7 high-signal tools so agent context is not crowded by rarely used schemas. Use `memorix serve --mode lite` for the extended solo memory surface, `--mode team` for coordination tools, or `--mode full` for advanced and MCP Memory compatibility tools.
154
+ The stdio server defaults to `--mode micro`, which exposes 9 high-signal tools so agent context is not crowded by rarely used schemas. Use `memorix serve --mode lite` for the extended solo memory surface, `--mode team` for coordination tools, or `--mode full` for advanced and MCP Memory compatibility tools.
148
155
 
149
156
  Generic stdio MCP config:
150
157
 
@@ -560,7 +567,7 @@ Use the `team`, `task`, `message`, `handoff`, and `lock` CLI commands when you n
560
567
 
561
568
  ### `memorix` opens memcode
562
569
 
563
- That is expected in the 1.1 line. Use `memorix --help` to see the full CLI and `memorix serve` for MCP.
570
+ That is expected in the current release line. Use `memorix --help` to see the full CLI and `memorix serve` for MCP.
564
571
 
565
572
  ### No project memory appears
566
573
 
@@ -666,6 +673,7 @@ Common MCP config locations:
666
673
  | Hermes Agent | `%LOCALAPPDATA%\hermes\config.yaml` on native Windows, `~/.hermes/config.yaml` elsewhere, or `HERMES_HOME\config.yaml` |
667
674
  | Oh-my-Pi | `.omp/mcp.json` or `~/.omp/agent/mcp.json` |
668
675
  | Trae | `%APPDATA%/Trae/User/mcp.json` on Windows |
676
+ | DeepSeek Harness | `$DSH_HOME/cordis.patch.yml` (default `~/.dsh/cordis.patch.yml`) |
669
677
 
670
678
  ---
671
679
 
@@ -85,7 +85,8 @@ memorix hook <normalized_event> [--agent <agent_name>]
85
85
  ```bash
86
86
  memorix hooks install
87
87
  # 自动检测已安装的 Agent → 生成对应配置文件
88
- # 支持: --agent cursor|windsurf|claude|copilot|kiro
88
+ # 支持: --agent claude|codex|cursor|windsurf|copilot|opencode|kiro|antigravity|gemini-cli|trae
89
+ # openclaw/hermes/omp/codex 的 hooks 随插件包安装,使用 `memorix setup --agent <agent>`
89
90
  # 支持: --project (仅当前项目) | --global (全局)
90
91
  ```
91
92
 
package/llms-full.txt CHANGED
@@ -2,11 +2,11 @@
2
2
 
3
3
  > Local-first shared memory layer for AI coding agents.
4
4
 
5
- Memorix is a TypeScript/Node.js project that gives AI coding agents persistent, project-aware memory. It targets software development workflows, not generic chat. It works across Claude Code, Codex, Cursor, Windsurf, GitHub Copilot CLI, Gemini CLI, OpenCode, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Kiro, Antigravity, Trae, and any agent that can speak MCP over stdio or HTTP. Integrations usually start with `memorix setup --agent <agent> --global`, which installs the recommended user-level package or config for that agent: plugin packages when supported, package or extension entries, MCP config, generated guidance, hooks, skills, or the bundled terminal agent.
5
+ Memorix is a TypeScript/Node.js project that gives AI coding agents persistent, project-aware memory. It targets software development workflows, not generic chat. It works across Claude Code, Codex, CodeBuddy Code, Cursor, Windsurf, GitHub Copilot CLI, Gemini CLI, OpenCode, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Kiro, Antigravity, Trae, DeepSeek Harness, and any agent that can speak MCP over stdio or HTTP. Integrations usually start with `memorix setup --agent <agent> --global`, which installs the recommended user-level package or config for that agent: plugin packages when supported, package or extension entries, MCP config, generated guidance, hooks, skills, or the bundled terminal agent.
6
6
 
7
7
  If you are an AI coding agent helping a user install, operate, or troubleshoot Memorix, read `docs/AGENT_OPERATOR_PLAYBOOK.md` before taking action. It is the main reference for install, runtime selection, Git/project binding, MCP integration, hooks, and troubleshooting.
8
8
 
9
- ## 1.3 Multi-Dimensional Memory Model
9
+ ## 1.4 Multi-Dimensional Memory Model
10
10
 
11
11
  Memorix is not a transcript dump. The normal agent path is `memorix_project_context` or `memorix context --task "..."`, which assembles a bounded task Workset: current Git/package facts, selected observations and reasoning, Code State freshness, source-backed claims, matching knowledge/workflow starts, cautions, and verification hints.
12
12
 
@@ -36,6 +36,7 @@ It installs the recommended Memorix integration for the target agent:
36
36
  - Gemini CLI: local Gemini extension package with MCP and `GEMINI.md` context.
37
37
  - OpenCode: local plugin file, `opencode.json` MCP config, OpenCode skill, and `AGENTS.md` guidance.
38
38
  - Windsurf, Kiro, Antigravity, Trae: MCP config plus rules/hooks where supported.
39
+ - DeepSeek Harness: MCP patch row (`$DSH_HOME/cordis.patch.yml`) plus `AGENTS.md` guidance and official skills.
39
40
 
40
41
  Use:
41
42
 
@@ -131,7 +132,7 @@ memorix orchestrate --goal "Add authentication"
131
132
  - plugin packages: Claude Code, Codex, and GitHub Copilot CLI
132
133
  - package or extension entries: Pi package and Gemini CLI extension package
133
134
  - local plugins: OpenCode local plugin file and skill
134
- - project instructions and rules: AGENTS.md, GEMINI.md, Cursor rules, Windsurf rules, Kiro steering, Trae rules
135
+ - project instructions and rules: AGENTS.md, GEMINI.md, Cursor rules, Windsurf rules, Kiro steering, Trae rules, DeepSeek Harness AGENTS.md
135
136
  - hooks: agent event capture routed through `memorix hook`
136
137
  - skills: durable project knowledge promoted into reusable task guidance
137
138
 
@@ -365,7 +366,7 @@ Docker is for the HTTP service. The container must have access to the repositori
365
366
 
366
367
  ## Supported Clients
367
368
 
368
- Memorix supports Claude Code, Codex, Cursor, Windsurf, GitHub Copilot CLI, Gemini CLI, OpenCode, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Kiro, Antigravity, Trae, memcode, and other stdio or HTTP MCP clients.
369
+ Memorix supports Claude Code, Codex, CodeBuddy Code, Cursor, Windsurf, GitHub Copilot CLI, Gemini CLI, OpenCode, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Kiro, Antigravity, Trae, DeepSeek Harness, memcode, and other stdio or HTTP MCP clients.
369
370
 
370
371
  Support depth differs by client:
371
372
 
@@ -374,7 +375,7 @@ Support depth differs by client:
374
375
  - Claude Code, Codex, and GitHub Copilot CLI receive local plugin packages.
375
376
  - Pi receives a user-level package when setup runs with `--global`; Gemini CLI receives a local extension package.
376
377
  - OpenClaw receives a compatible bundle; Hermes Agent receives a plugin package; Oh-my-Pi receives a package/extension entry.
377
- - Project instructions and rules include AGENTS.md, GEMINI.md, Cursor rules, Windsurf rules, Kiro steering, and Trae rules.
378
+ - Project instructions and rules include AGENTS.md, GEMINI.md, Cursor rules, Windsurf rules, Kiro steering, Trae rules, and DeepSeek Harness AGENTS.md.
378
379
  - Hooks are generated for agents that expose usable hook events.
379
380
  - OpenCode receives a local plugin file at `.opencode/plugins/memorix.js`, an OpenCode skill at `.opencode/skills/memorix-memory/SKILL.md`, plus `opencode.json` MCP config.
380
381
  - memcode is the bundled terminal agent and uses the same project memory pool.
@@ -474,6 +475,6 @@ npm run build
474
475
 
475
476
  Requirements:
476
477
 
477
- - Node.js `>=22.19.0`
478
+ - Node.js `>=22.18.0`
478
479
  - npm
479
480
  - Git
package/llms.txt CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  > Local-first shared memory layer for AI coding agents.
4
4
 
5
- Memorix gives coding agents persistent, project-aware memory across sessions, IDEs, terminals, and MCP clients. It stores project knowledge once so multiple agents can retrieve it through plugin packages, MCP, CLI, SDK, generated rules/instructions, hooks, skills, local plugins, or the bundled terminal agent. It works with Claude Code, Codex, Cursor, Windsurf, GitHub Copilot CLI, Gemini CLI, OpenCode, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Kiro, Antigravity, Trae, and other MCP-capable agents.
5
+ Memorix gives coding agents persistent, project-aware memory across sessions, IDEs, terminals, and MCP clients. It stores project knowledge once so multiple agents can retrieve it through plugin packages, MCP, CLI, SDK, generated rules/instructions, hooks, skills, local plugins, or the bundled terminal agent. It works with Claude Code, Codex, CodeBuddy Code, Cursor, Windsurf, GitHub Copilot CLI, Gemini CLI, OpenCode, OpenClaw, Hermes Agent, Oh-my-Pi, Pi, Kiro, Antigravity, Trae, DeepSeek Harness, and other MCP-capable agents.
6
6
 
7
7
  ## Entry Points
8
8
 
@@ -10,7 +10,7 @@ Memorix gives coding agents persistent, project-aware memory across sessions, ID
10
10
  - `memorix setup --list` lists supported agent entry points.
11
11
  - `memorix serve` starts the manual stdio MCP server for IDEs and agents.
12
12
  - `memorix background start` starts the HTTP MCP service and dashboard.
13
- - `memorix memory`, `codegraph`, `knowledge`, `reasoning`, `session`, `team`, `task`, `handoff`, `poll`, `receipt`, `sync`, `ingest`, and `orchestrate` expose the CLI command set.
13
+ - `memorix memory`, `codegraph`, `knowledge`, `reasoning`, `session`, `team`, `task`, `handoff`, `poll`, `receipt`, `sync`, `media`, `ingest`, and `orchestrate` expose the CLI command set.
14
14
  - `memorix integrate --agent <agent>` and `memorix hooks install --agent <agent>` are manual/fallback generation commands.
15
15
  - `memorix` and `memcode` open memcode, the bundled terminal agent that uses the same project memory pool.
16
16
  - `memorix dashboard` opens the local read-mostly dashboard.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "memorix",
3
3
  "mcpName": "io.github.AVIDS2/memorix",
4
- "version": "1.4.3",
4
+ "version": "1.4.5",
5
5
  "description": "Local-first shared memory layer for AI coding agents across MCP clients, Git history, reasoning context, and project sessions.",
6
6
  "type": "module",
7
7
  "sideEffects": false,
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://anthropic.com/claude-code/plugin.schema.json",
3
3
  "name": "memorix",
4
- "version": "1.4.3",
4
+ "version": "1.4.5",
5
5
  "description": "Shared workspace memory for Claude Code and other AI coding agents.",
6
6
  "author": {
7
7
  "name": "AVIDS2",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "memorix",
3
- "version": "1.4.3",
3
+ "version": "1.4.5",
4
4
  "description": "Local-first project memory for CodeBuddy Code and other coding agents.",
5
5
  "author": {
6
6
  "name": "AVIDS2",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "memorix",
3
- "version": "1.4.3",
3
+ "version": "1.4.5",
4
4
  "description": "Shared workspace memory for Codex and other AI coding agents.",
5
5
  "author": {
6
6
  "name": "AVIDS2",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "memorix",
3
- "version": "1.4.3",
3
+ "version": "1.4.5",
4
4
  "description": "Shared local workspace memory for GitHub Copilot CLI and other AI coding agents.",
5
5
  "author": {
6
6
  "name": "AVIDS2",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "memorix",
3
- "version": "1.4.3",
3
+ "version": "1.4.5",
4
4
  "mcpServers": {
5
5
  "memorix": {
6
6
  "command": "memorix",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "memorix-omp-package",
3
- "version": "1.4.3",
3
+ "version": "1.4.5",
4
4
  "description": "Memorix shared workspace memory package for Oh-my-Pi.",
5
5
  "license": "Apache-2.0",
6
6
  "keywords": [
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "memorix",
3
- "version": "1.4.3",
3
+ "version": "1.4.5",
4
4
  "description": "Shared workspace memory for OpenClaw and other AI coding agents.",
5
5
  "author": {
6
6
  "name": "AVIDS2",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "memorix-pi-package",
3
- "version": "1.4.3",
3
+ "version": "1.4.5",
4
4
  "description": "Memorix shared workspace memory package for Pi coding agent.",
5
5
  "license": "Apache-2.0",
6
6
  "keywords": [
package/server.json CHANGED
@@ -7,7 +7,7 @@
7
7
  "url": "https://github.com/AVIDS2/memorix",
8
8
  "source": "github"
9
9
  },
10
- "version": "1.4.3",
10
+ "version": "1.4.5",
11
11
  "websiteUrl": "https://github.com/AVIDS2/memorix#readme",
12
12
  "icons": [
13
13
  {
@@ -22,7 +22,7 @@
22
22
  {
23
23
  "registryType": "npm",
24
24
  "identifier": "memorix",
25
- "version": "1.4.3",
25
+ "version": "1.4.5",
26
26
  "runtimeHint": "npx",
27
27
  "packageArguments": [
28
28
  {