【ai-memory】赋予 AI 编程助手持久记忆：跨工具无缝接续的上下文管理方案
这是一个为 AI 编程代理提供长期共享记忆的上下文管理工具。它解决了 AI 助手在会话结束时丢失上下文的痛点，让你可以在不同 AI 工具（如 Claude Code 和 Codex）之间无缝切换，而无需向新接手的 AI 重复解释项目架构、历史决策或未完成的任务。
主要功能与特性
- 零摩擦上下文捕获：自动记录并清理提示词、工具调用和会话边界信息，单次观察最大支持 16 KiB，无需手动干预。
- 跨代理无缝交接：中途退出一个 AI 工具并启动另一个时，新工具会自动接收包含未决问题、下一步计划和会话摘要的“交接文档”。
- 纯 Markdown 知识库：采用 Git 版本控制的纯文本 Wiki 存储，支持
grep搜索，无需维护复杂的向量数据库。 - 广泛的多工具支持：兼容 Claude Code、Codex、Cursor、Gemini CLI、Devin CLI 等数十种主流 AI 编程工具。
- 智能召回机制：结合全文搜索（FTS5）、实体匹配和权限感知，优先展示核心规则和决策，同时支持可选的向量搜索。
- 项目级隔离与全局偏好：每个项目的上下文基于 UUID 独立隔离，同时支持全局共享代码风格、技术选型等长期偏好。
- 内置 Web 界面：提供只读的 HTML UI，方便在浏览器中浏览项目树、进行搜索和查看 Markdown 渲染内容。
- LLM 可选模式：即使不配置大语言模型，也能使用基础的全文搜索、实体匹配和基于规则的总结功能。
安装与使用示例
如果你使用的是 Arch Linux，可以通过 AUR 快速安装并配置单用户服务：
# 安装预编译二进制包
yay -S ai-memory-bin
# 初始化配置并启动用户级服务
mkdir -p ~/.config/ai-memory ~/.local/share/ai-memory
ai-memory --data-dir ~/.local/share/ai-memory \
--config ~/.config/ai-memory/config.toml init
systemctl --user enable --now ai-memory.service
# 为 Claude Code 安装 MCP 配置和生命周期 Hooks
ai-memory install-mcp --client claude-code --apply
ai-memory install-hooks --agent claude-code --apply
日常使用示例：
# 使用托管模式启动 Claude Code 进行开发
ai-memory run claude
# 退出后，无缝切换到 Codex 继续同一工作流
ai-memory run codex --yolo
# 在任何目录下，快速恢复最近一次的工作流
ai-memory continue
# 在终端中搜索历史决策或项目规则
ai-memory search "数据库选型"
适用场景与目标用户
- 适用场景：需要频繁切换不同 AI 编程工具进行接力开发；长期维护大型项目，需要 AI 记住历史决策、失败尝试和代码规范；多设备或家庭实验室（Homelab）环境下的 AI 记忆共享与集中管理。
- 目标用户：重度依赖 AI 辅助编程的开发者、需要在多个 AI 代理间寻找最优解的工程师，以及希望为团队或家庭服务器统一部署 AI 上下文服务的极客用户。
总结
该项目巧妙地将 AI 会话记录转化为结构化的 Markdown Wiki，彻底打破了不同 AI 编程工具之间的上下文壁垒。它轻量、无需绑定特定的向量数据库，且对主流 AI 代理的支持极为全面。对于希望让 AI 真正理解并记住项目全貌、实现跨工具连贯开发的开发者来说，这是一个极具实用价值的效率工具。
