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.
- package/CHANGELOG.md +34 -0
- package/README.md +20 -6
- package/README.zh-CN.md +16 -3
- package/TEAM.md +86 -86
- package/assets/star-history-dark.svg +8 -8
- package/assets/star-history-light.svg +8 -8
- package/assets/star-history.json +16 -2
- package/dist/cli/index.js +539 -233
- package/dist/cli/memcode.js +0 -0
- package/dist/index.js +72 -15
- package/dist/maintenance-runner.js +9 -7
- package/dist/media-audio-runner.js +9 -7
- package/dist/media-video-runner.js +9 -7
- package/dist/memcode/index.js +9 -7
- package/dist/memcode-runtime/CHANGELOG.md +34 -0
- package/dist/sdk.js +71 -14
- package/dist/types.d.ts +1 -1
- package/dist/vector-backfill-runner.js +9 -7
- package/docs/AGENT_OPERATOR_PLAYBOOK.md +6 -5
- package/docs/API_REFERENCE.md +9 -5
- package/docs/CONFIGURATION.md +15 -5
- package/docs/DESIGN_DECISIONS.md +357 -357
- package/docs/DEVELOPMENT.md +2 -2
- package/docs/INTEGRATIONS.md +9 -2
- package/docs/KNOWN_ISSUES_AND_ROADMAP.md +4 -3
- package/docs/MEMCODE.md +1 -1
- package/docs/MODULES.md +1 -1
- package/docs/README.md +1 -1
- package/docs/SETUP.md +12 -4
- package/docs/hooks-architecture.md +2 -1
- package/llms-full.txt +7 -6
- package/llms.txt +2 -2
- package/package.json +1 -1
- package/plugins/claude/memorix/.claude-plugin/plugin.json +1 -1
- package/plugins/codebuddy/memorix/.codebuddy-plugin/plugin.json +1 -1
- package/plugins/codex/memorix/.codex-plugin/plugin.json +1 -1
- package/plugins/copilot/memorix/plugin.json +1 -1
- package/plugins/gemini/memorix/gemini-extension.json +1 -1
- package/plugins/omp/memorix/package.json +1 -1
- package/plugins/openclaw/memorix/.codex-plugin/plugin.json +1 -1
- package/plugins/pi/memorix/package.json +1 -1
- package/server.json +2 -2
- package/src/audit/index.ts +156 -156
- package/src/cli/commands/agent-integrations.ts +7 -1
- package/src/cli/commands/audit-list.ts +89 -89
- package/src/cli/commands/formation.ts +48 -48
- package/src/cli/commands/git-hook-install.ts +111 -111
- package/src/cli/commands/handoff.ts +54 -54
- package/src/cli/commands/hooks-install.ts +2 -0
- package/src/cli/commands/hooks-preview.ts +5 -0
- package/src/cli/commands/hooks-status.ts +63 -63
- package/src/cli/commands/ingest.ts +44 -44
- package/src/cli/commands/integrate-shared.ts +15 -15
- package/src/cli/commands/integrate.ts +2 -0
- package/src/cli/commands/lock.ts +82 -82
- package/src/cli/commands/media-image.ts +27 -0
- package/src/cli/commands/media.ts +8 -1
- package/src/cli/commands/memory.ts +44 -34
- package/src/cli/commands/message.ts +104 -104
- package/src/cli/commands/operator-shared.ts +62 -18
- package/src/cli/commands/poll.ts +58 -58
- package/src/cli/commands/purge-all-memory.ts +85 -85
- package/src/cli/commands/purge-project-memory.ts +83 -83
- package/src/cli/commands/reasoning.ts +118 -118
- package/src/cli/commands/setup.ts +57 -2
- package/src/cli/commands/skills.ts +114 -114
- package/src/cli/commands/task.ts +167 -167
- package/src/cli/commands/transfer.ts +47 -47
- package/src/cli/commands/uninstall-project-artifacts.ts +85 -85
- package/src/cli/commands/uninstall.ts +20 -0
- package/src/cli/tui/ChatView.tsx +234 -234
- package/src/cli/tui/CommandBar.tsx +312 -312
- package/src/cli/tui/ContextRail.tsx +118 -118
- package/src/cli/tui/HeaderBar.tsx +72 -72
- package/src/cli/tui/LogoBanner.tsx +51 -51
- package/src/cli/tui/Sidebar.tsx +179 -179
- package/src/cli/tui/index.ts +41 -41
- package/src/cli/tui/markdown-render.tsx +371 -371
- package/src/cli/tui/use-mouse.ts +157 -157
- package/src/cli/tui/useNavigation.ts +56 -56
- package/src/cli/version.ts +7 -7
- package/src/cli/workbench.ts +1 -1
- package/src/dashboard/project-classification.ts +64 -64
- package/src/git/hooks-path.ts +85 -85
- package/src/hooks/installers/index.ts +43 -2
- package/src/hooks/pattern-detector.ts +173 -173
- package/src/hooks/significance-filter.ts +250 -250
- package/src/hooks/types.ts +2 -0
- package/src/integrations/registry.ts +9 -0
- package/src/llm/memory-manager.ts +328 -328
- package/src/llm/provider.ts +885 -885
- package/src/llm/quality.ts +248 -248
- package/src/media/minimax.ts +9 -1
- package/src/memory/attribution-guard.ts +249 -249
- package/src/memory/disclosure-policy.ts +135 -135
- package/src/memory/entity-extractor.ts +197 -197
- package/src/memory/formation/evaluate.ts +217 -217
- package/src/memory/formation/extract.ts +361 -361
- package/src/memory/formation/index.ts +417 -417
- package/src/memory/formation/resolve.ts +344 -344
- package/src/memory/formation/types.ts +315 -315
- package/src/memory/freshness.ts +122 -122
- package/src/memory/graph.ts +197 -197
- package/src/memory/refs.ts +94 -94
- package/src/memory/secret-filter.ts +79 -79
- package/src/orchestrate/adapters/claude-stream.ts +192 -192
- package/src/orchestrate/adapters/claude.ts +111 -111
- package/src/orchestrate/adapters/codex-stream.ts +134 -134
- package/src/orchestrate/adapters/codex.ts +41 -41
- package/src/orchestrate/adapters/gemini-stream.ts +166 -166
- package/src/orchestrate/adapters/gemini.ts +42 -42
- package/src/orchestrate/adapters/index.ts +73 -73
- package/src/orchestrate/adapters/opencode-stream.ts +143 -143
- package/src/orchestrate/adapters/opencode.ts +47 -47
- package/src/orchestrate/adapters/types.ts +77 -77
- package/src/orchestrate/capability-router.ts +284 -284
- package/src/orchestrate/context-compact.ts +188 -188
- package/src/orchestrate/cost-tracker.ts +219 -219
- package/src/orchestrate/error-recovery.ts +191 -191
- package/src/orchestrate/evidence.ts +140 -140
- package/src/orchestrate/ledger.ts +110 -110
- package/src/orchestrate/memorix-bridge.ts +343 -343
- package/src/orchestrate/output-budget.ts +80 -80
- package/src/orchestrate/permission.ts +152 -152
- package/src/orchestrate/pipeline-trace.ts +131 -131
- package/src/orchestrate/prompt-builder.ts +155 -155
- package/src/orchestrate/ring-buffer.ts +37 -37
- package/src/orchestrate/task-graph.ts +389 -389
- package/src/project/aliases.ts +374 -374
- package/src/rules/adapters/trae.ts +56 -56
- package/src/rules/syncer.ts +235 -235
- package/src/search/query-expansion.ts +52 -52
- package/src/server/formation-timeout.ts +27 -27
- package/src/server.ts +23 -1
- package/src/skills/mini-skills.ts +386 -386
- package/src/store/chat-store.ts +119 -119
- package/src/store/graph-store.ts +249 -249
- package/src/store/mini-skill-store.ts +349 -349
- package/src/store/persistence-json.ts +212 -212
- package/src/store/persistence.ts +291 -291
- package/src/store/project-affinity.ts +195 -195
- package/src/team/event-bus.ts +76 -76
- package/src/team/file-locks.ts +173 -173
- package/src/team/handoff.ts +161 -161
- package/src/team/messages.ts +203 -203
- package/src/team/poll.ts +132 -132
- package/src/team/tasks.ts +211 -211
- package/src/types.ts +1 -1
- package/src/workspace/mcp-adapters/codex.ts +191 -191
- package/src/workspace/mcp-adapters/copilot.ts +105 -105
- package/src/workspace/mcp-adapters/cursor.ts +53 -53
- package/src/workspace/mcp-adapters/dsh.ts +147 -0
- package/src/workspace/mcp-adapters/kiro.ts +64 -64
- package/src/workspace/mcp-adapters/opencode.ts +123 -123
- package/src/workspace/mcp-adapters/trae.ts +134 -134
- package/src/workspace/mcp-adapters/windsurf.ts +91 -91
- package/src/workspace/sanitizer.ts +60 -60
- package/dist/memcode-runtime/docs/images/exy.png +0 -0
package/docs/DEVELOPMENT.md
CHANGED
|
@@ -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.
|
|
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.
|
|
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
|
package/docs/INTEGRATIONS.md
CHANGED
|
@@ -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-
|
|
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
|
-
| 媒体记忆 |
|
|
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
|
-
-
|
|
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
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.
|
|
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
|
|
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
|
|
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
|
|
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|
|
|
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.
|
|
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
|
|
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.
|
|
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.
|
|
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,
|
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.
|
|
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.
|
|
25
|
+
"version": "1.4.5",
|
|
26
26
|
"runtimeHint": "npx",
|
|
27
27
|
"packageArguments": [
|
|
28
28
|
{
|