Repolode
akitaonrails

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. 1

    在 Linux 或 macOS 上安装二进制文件

    按 README 中的官方说明安装
  2. 2

    设置数据目录、服务和智能体接入

    ai-memory setup
  3. 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 数据每日更新。

相关项目