ai-memory
SHA-256ai-memory 是一个为 AI 编程助手提供长期记忆的开源工具，基于 git 仓库中的 Markdown 文件，支持 Claude Code、Codex、Cursor 等主流代理，让你在不同工具间切换时无需重复解释上下文。相比需要向量数据库的记忆方案，它更轻量、完全本地化。
给 AI 编程助手一个持久记忆，跨工具无缝交接上下文。
核心功能
- 跨代理记忆共享：支持 Claude Code、Codex、Cursor、Gemini CLI、OpenCode 等十余种编程代理，会话结束后自动生成交接摘要
- 纯 Markdown + git 存储：记忆是普通文件，可用 grep 搜索、Obsidian 打开、rsync 备份，无需数据库或额外服务
- 零摩擦自动捕获：通过生命周期钩子自动记录提示词、工具调用和会话边界，无需手动写笔记
- 可选托管工作流：`ai-memory run` 可直接启动代理并跨会话恢复同一工作流，支持多种 AI 工具之间切换
避坑指南
- •不是所有代理都支持完整的会话结束钩子（如 Codex、Kiro CLI），需要在最后手动运行 `ai-memory finalize-session` 来生成最终摘要
- •原生 Windows 支持目前是实验性的，推荐在 WSL2 中使用 Linux 版本
- •捕获的观察数据经过脱敏，不是完整的原生对话记录，某些细节可能丢失
- •MCP 配置和钩子安装可能需要手动调整不同代理的配置文件，建议先阅读对应的文档
适用场景
- 开发者在多个 AI 编程代理（如 Claude Code 和 Codex）之间切换，希望保留项目上下文和未完成的任务
- 团队希望将 AI 会话的知识沉淀为可搜索、可版本化的 Markdown 文档，便于长期积累和交接
详细介绍
ai-memory 是一个开源的 Rust 工具（MIT 协议），专门解决 AI 编程助手“换会话就失忆”的痛点。它通过 MCP 配置和生命周期钩子，支持 Claude Code、Codex、Command Code、Cursor、Gemini CLI 等多种编程代理，自动捕获会话中的提示词、工具调用和会话边界，并在会话结束时生成有条理的摘要，让下一个代理无需重新解释项目架构、失败尝试或待解决问题。所有记忆以纯 Markdown 形式保存在本地 git 仓库中，可直接 grep、可用 Obsidian 打开、能用 rsync 备份——不需要维护向量数据库，也无需手动写笔记。它还可以通过 `ai-memory run` 启动“托管工作流”，在不同代理间实现更精确的恢复。相比单独的记忆插件或重型 RAG 方案，ai-memory 更轻量、供应商中立，特别适合在多种 AI 编程工具之间无缝切换的场景。
标签
快速上手
安装软件
根据你的发行版安装对应的包（dpkg / rpm / AppImage）
从 GitHub Releases 下载对应平台（Linux/macOS/Windows）的压缩包，解压后把可执行文件放到 PATH 中
运行 `ai-memory install-mcp --client <你的代理名>` 并按照提示完成 MCP 配置
运行 `ai-memory install-hooks --agent <你的代理名>` 安装生命周期钩子
- 从 GitHub Releases 下载对应平台（Linux/macOS/Windows）的压缩包，解压后把可执行文件放到 PATH 中
- 运行 `ai-memory install-mcp --client <你的代理名>` 并按照提示完成 MCP 配置
- 运行 `ai-memory install-hooks --agent <你的代理名>` 安装生命周期钩子
已提供 SHA-256 校验码，下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
9eed6fb25cc7a057c8e622eb42b83bfcd366858cfb4fd59847a4a4a9ca87a838该校验码提取自 GitHub Release 页面，下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
运行 `ai-memory uninstall-hooks --agent <你的代理名>` 移除生命周期钩子，用 `ai-memory uninstall-mcp --client <你的代理名>` 删除 MCP 配置，然后删除下载的可执行文件和 `~/.ai-memory` 目录即可。
无额外依赖
下载后即可直接使用，无需安装其他运行环境