为 Claude Code、Cursor、Codex 等 AI 编程助手提供持久化记忆,自动记录会话并在新会话中注入相关上下文。
akitaonrails/ai-memory
为 AI 编程代理提供长期记忆,在 Claude Code、Codex、Cursor 等多种代理 CLI 之间共享项目上下文与交接。
- Star
- 10,811
- Fork
- 765
- 未关闭 Issue
- 11
- 最近提交
- 前天
这是什么?
ai-memory 是面向 AI 编程代理的长期记忆层。当你从一个代理(例如 Claude Code)切换到另一个代理(例如 OpenAI Codex)继续同一项目时,新代理会收到交接信息,包括工作进展、失败的尝试和未解决的问题,无需每次重新解释架构。
生命周期 hook 会记录提问、工具调用和会话边界,并在入库前完成脱敏,会话结束后再整理成 git 管理的 markdown wiki 页面。wiki 文件是唯一数据源,用于检索的 SQLite 索引可以随时从文件重建。检索结合全文搜索、实体与图关系匹配,以及可选的向量搜索。默认路径不调用任何 LLM,也可以配置 LLM 提供商以获得更好的摘要和语义搜索。
服务端可以运行在个人电脑、家庭实验室或局域网主机上,团队也能共用,并支持按人认证和审计日志。项目以单个 Rust 二进制文件发布,可通过安装脚本、Docker、NixOS 模块,或 Arch、Fedora 的软件包安装。
核心功能
- 01在 Claude Code、Codex、Cursor、Gemini CLI 等二十多种代理 CLI 之间共享交接信息。
- 02记忆以普通 markdown 文件保存在 git 管理的 wiki 中,可直接手动编辑。
- 03通过生命周期 hook 自动记录会话,入库前完成脱敏。
- 04默认无需调用 LLM,LLM 与向量嵌入提供商均为可选。
- 05支持多用户认证、按人归属和审计日志,适合团队共用。
适用场景
- 在同一代码仓库中切换 Claude Code 与 Codex,且不丢失上下文。
- 在家庭实验室服务器上保存共享项目记忆,并在笔记本上继续工作。
- 为团队建立统一且可审计的知识库,供每位开发者的代理检索。
- 代理额度用尽或异常退出、未写交接时,仍能接续任务。
快速上手
- 1
在 Linux 或 macOS 上安装二进制文件
按 README 中的官方说明安装 - 2
设置数据目录、服务和智能体接入
ai-memory setup - 3
重启智能体,并询问其对该项目的记忆内容
使用前须知
- 原生 Windows 支持处于实验阶段;受支持的方式是 WSL2。
- 部分智能体只做了部分集成,例如仅支持 MCP、仅支持钩子或仅支持托管模式。
- 要在多台机器或团队间共享记忆,需要自行运行服务器。
标签
常见问题
- ai-memory 是什么?
- 为 AI 编程代理提供长期记忆,在 Claude Code、Codex、Cursor 等多种代理 CLI 之间共享项目上下文与交接。 ai-memory 是面向 AI 编程代理的长期记忆层。当你从一个代理(例如 Claude Code)切换到另一个代理(例如 OpenAI Codex)继续同一项目时,新代理会收到交接信息,包括工作进展、失败的尝试和未解决的问题,无需每次重新解释架构。
- ai-memory 可以免费使用吗?用的什么许可证?
- ai-memory 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- ai-memory 还在维护吗?
- 活跃维护中。ai-memory 最近一次提交是在 2026年10月19日。
- ai-memory 适合用来做什么?
- 在同一代码仓库中切换 Claude Code 与 Codex,且不丢失上下文。 在家庭实验室服务器上保存共享项目记忆,并在笔记本上继续工作。 为团队建立统一且可审计的知识库,供每位开发者的代理检索。 代理额度用尽或异常退出、未写交接时,仍能接续任务。
- ai-memory 怎么安装和运行?
- 在 Linux 或 macOS 上安装二进制文件 设置数据目录、服务和智能体接入: ai-memory setup 重启智能体,并询问其对该项目的记忆内容
- 在哪里获取 ai-memory?
- 源代码和安装说明在 GitHub 上:https://github.com/akitaonrails/ai-memory
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
让 AI 智能体通过 MCP 和命令行逆向分析原生二进制、Electron 应用、.NET 程序集和网站。
一款原生桌面应用,把 Claude Code、Codex 等多种编程 Agent 的会话集中到一处,可搜索、可回看、可续接。
开源桌面 AI 智能体应用与 Rust 库,可低成本运行大量智能体。
面向 AI 智能体的本地优先 Markdown 记忆工作区,可将长期知识存为可编辑文件并检索整理。