ai-memory：给多个编码 Agent 共用一套可持久化项目记忆
一分钟看懂
ai-memory 是 Rust 编写的自托管记忆服务，用来减少 Claude Code、Codex、Cursor、OpenCode 等工具每次都从零理解项目的问题。它把项目资料、决策与进度整理进可搜索 wiki，通过 MCP、hooks、CLI 和 HTTP 让不同 Agent 共享上下文。
你可以用它做什么
- 在会话开始、压缩或结束时保存并恢复项目背景。
- 用 bootstrap 将
AGENTS.md、README、文档和有内容的 Git 提交变成初始记忆。 - 从多种客户端或不同电脑连接同一实例。
- 搜索、备份、恢复页面、审计污染，并用可选嵌入改善检索。
主要能力
服务端是唯一写入者，CLI 只经 HTTP 操作，不直接改 SQLite/wiki。项目支持 Docker 和源码运行，提供 Web 浏览、JSON API、MCP 与 hook 端点；可配置远程 LLM 或本地 Ollama，并为多种 Agent 生成配置。
适合哪些人
适合频繁切换 Agent、维护长期代码库、希望跨机器共享上下文的开发者和小团队，也适合愿意维护 Docker、认证令牌与备份的 homelab 用户。
怎么开始使用
最省事的是运行官方 Docker 镜像，在 127.0.0.1:49374 暴露服务并挂载数据卷，再用 install-mcp、install-hooks 或 setup-agent 配置客户端。也可执行 cargo build --release --workspace，然后 ai-memory init 与 ai-memory serve --transport http。旧项目可运行 ai-memory bootstrap。
使用前需要知道
绑定非回环地址时必须配置认证令牌和允许的 Host，不要裸露公网。远程模型、嵌入和数据合成可能上传项目内容，应先确认隐私边界。记忆会过时或出错，不能代替源代码、测试与人工判断，服务数据也需单独备份。