AVIDS2/memorix

Memorix – 面向AI编码代理的共享、本地优先的记忆层

它是什么 – Memorix是一个Node.js库/CLI，可在您正在操作的Git存储库内部创建一个可搜索、版本控制的记忆存储。该存储位于本地SQLite数据库（可选全文和语义索引）中，并暴露给任何理解Model-Context-Protocol（MCP）或可加载插件/钩子的AI编码助手。

为什么重要 – 当您在代理（Claude Code、GitHub Copilot CLI、Cursor等）或IDE和终端会话之间切换时，每个工具通常从空白的聊天历史开始。Memorix让代理共享相同的项目级事实、设计原理、代码快照和提交衍生的知识，因此您无需重新解释相同的上下文。

主要功能

功能	您获得的内容
记忆自动驾驶仪	捆绑开始文件、当前记忆和验证步骤的受限“工作集”JSON。
观察记忆	针对当前Git仓库范围的可搜索事实、修复、注意事项和会话摘要。
Git记忆	自动将提交摄取为可搜索的工程事实（发生了什么变化，为什么重要）。
推理记忆	存储设计决策、替代方案和权衡，供将来参考。
代码记忆/代码图	版本化代码快照、TypeScript/JavaScript的符号级索引和新鲜度检查。
知识工作区	经审查的Markdown页面和规范工作流，不会静默覆盖。
编排	协调多代理任务、交接和验证循环的命令（memorix orchestrate、memorix lock、memorix team）。
仪表板与HTTP API	用于浏览记忆、诊断和清理的本地Web UI和可选HTTP端点。
捆绑终端代理 – memcode	一个可直接使用的CLI代理，读写相同的Memorix记忆，适用于快速原型设计。
同步	可选的隐私过滤同步到GitHub JSONL、S3、Postgres等，或通过MCP进行多设备共享。

工作原理 – 运行memorix init时，会创建~/.memorix/config.toml（全局）和/或<git-root>/memorix.toml（项目）。memorix setup --agent <name>随后为所选代理安装适当的插件、钩子或MCP配置。核心服务（memorix serve）运行基于stdio的MCP桥；单独的memorix serve-http可以通过HTTP向IDE或其他客户端公开相同的桥。

典型工作流程

1. 安装 – npm install -g memorix
2. 初始化 – memorix init --global（创建默认值）
3. 连接代理 – 例如：memorix setup --agent claude --global
4. 开始编码 – 代理现在可以查询memorix memory或memorix codegraph以检索先前的事实，您可以使用memorix reasoning或memorix ingest commit添加新的观察。
5. 编排 – 对于较大的任务，运行memorix orchestrate在代理之间交接工作，锁定文件，并强制执行验证步骤。

支持的代理 – README列出了数十个，包括Claude Code、OpenAI Codex、GitHub Copilot CLI、Cursor、Gemini CLI、Pi、Kiro、Antigravity、DeepSeek Harness、OpenClaw、Hermes Agent，以及任何实现MCP的客户端。

安装先决条件 – Node ≥ 22.18、Git（用于定位仓库根目录），以及可选的SQLite FTS5/LanceDB用于语义索引。

了解更多 – 仓库链接到网站、中文README、详细集成文档（docs/INTEGRATIONS.md）和活跃工作跟踪器（ACTIVE_WORK.md）。

---

以上信息均直接取自项目README；未添加外部假设。