ai-memory

让 AI 编程助手记住项目，换工具也不丢上下文

开源 free 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 9108

维护状态活跃

是否开源是

定价模式 free

项目预览

项目数据

分类智能体

开发团队akitaonrails

所属国家

官网地址

GitHubhttps://github.com/akitaonrails/ai-memory

定价模式free

价格说明开源免费，定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言Rust

技术栈/模型

GitHub 星标★ 9108

30天Star增速

HF 下载量

上线时间2026-05-21 00:00:00

代码更新—

仓库体积—

本站数据更新—

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-10-11

浏览次数0

项目介绍

ai-memory 是一个用 Rust 编写的长期记忆解决方案，专门面向各类智能体编程 CLI（如 Claude Code、Cursor CLI 等）。它解决的核心问题是：AI 编程助手每次会话结束后上下文全部丢失，切换不同厂商的智能体时也无法延续之前的工作状态。项目通过持久化存储会话记忆，让智能体能够跨会话、跨工具记住项目结构、代码决策和待办事项，并在不同厂商的智能体之间实现工作交接。核心能力包括：自动捕获和索引编程会话中的关键信息，提供检索接口供后续会话调用，支持多智能体供应商之间的记忆迁移。对于长期维护同一代码库、频繁使用多个 AI 编程工具的开发者来说，它相当于给智能体装上了可复用的外挂大脑，减少重复解释项目背景的成本。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

正在加载星标数据…

技术标签

使用教程

—

难度：入门约 10 分钟部署方式：Docker 7 步

环境要求

Docker 或 Podman（镜像提供 linux/amd64 与 linux/arm64 两种变体）
一个受支持的智能体 CLI，如 Claude Code、Codex、Cursor、Gemini CLI、OpenCode 等
Linux 或 macOS 主机（Windows x86_64 可用 zip 原生安装，见 docs/windows.md）
能访问 Docker 守护进程并挂载 $HOME 的普通用户环境

安装与启动步骤

1确认容器运行时

检查是否已安装 Docker 或 Podman。Apple Silicon 与 ARM64 Linux 可直接拉取 akitaonrails/ai-memory，无需 --platform 模拟。
2安装 ai-memory CLI

README 代码块中的具体安装命令未完整给出，安装脚本会把二进制放在容器内运行并挂载你的 $HOME；完整步骤见 docs/install.md。
3接入 Claude Code MCP

为 Claude Code 客户端写入 MCP 配置。换其他智能体时把 claude-code 换成 codex 等名称，可重复执行。
```
ai-memory install-mcp --client claude-code --apply
```
4安装捕获钩子

安装 hooks 后，提示词与工具调用会被捕获进 ai-memory。钩子按校验和验证的原生宿主客户端执行，可强制 ignore_paths 等策略。
```
ai-memory install-hooks --agent claude-code --apply
```
5启动智能体会话

推荐用 run 启动：首次运行会自动补齐该 harness 的 hooks 与 MCP，并自动绑定正确的项目作用域。
```
ai-memory run claude
```
6切换到其他智能体

在同一目录换另一个 harness 启动，即可读取上一个会话留下的交接信息，无需重新解释架构与失败尝试。
```
ai-memory run codex --yolo
```
7恢复最近会话

继续最新的受管工作副本，延续之前的工作流。
```
ai-memory continue
```

关键配置

配置项	必填	说明	示例
`AI_MEMORY_DOCKER`	否	Docker 与 Podman 同时存在时，强制使用 Podman	`podman`
`AI_MEMORY_HOOK_PLATFORM`	否	设为 posix 才启用旧版 shell 兼容路径，该路径无法执行捕获策略 v1	`posix`
`[capture] ignore_paths`	否	客户端捕获控制，事件进入 spool 或网络前忽略指定路径	`/your/project/secret`

如何确认成功

启动一个 Claude Code 会话，提示词与工具调用会写入 ai-memory；下次在同一项目打开会话可看到交接记录，明确上次断点、失败尝试与未决问题。

常见问题

Q：默认有身份认证吗？

A：没有认证。服务仅绑定回环地址 127.0.0.1:49374，单用户笔记本上其他程序访问不到；要暴露到局域网再加 bearer token，是一行改动。

Q：怎么接入 Claude Code 之外的智能体？

A：把命令里的名字换掉即可，例如 --client codex / --agent codex；支持二十多种 harness，逐行对照支持矩阵替换。

Q：服务连不上还能用吗？

A：能。ai-memory run 会告警并改用本地捕获 spool 继续启动；若希望失败即退出，加 --require-server 参数。

Q：两人或两个智能体同时用同一项目？

A：开箱即用。“当前项目”指针默认按调用方隔离（v1.39+）；团队共用服务器同样支持，可参考 docs/auto-scope.md。

Q：容器里怎么生成 OpenCode 产物？

A：容器无法探测宿主机可执行文件，需指定方言和输出目录：setup-agent --agent opencode --opencode-dialect v1|v2 --to /tmp/unused。

注意事项

默认无认证且只绑回环地址，单机使用安全；对外暴露前务必加 bearer token。
示例命令用 docker，Podman 主机请替换为 podman；未安装 Docker 时包装器会自动使用 Podman。
Linux/macOS 上钩子通过校验和验证的原生宿主客户端执行，才能强制执行 ignore_paths 与白名单模式。
原生安装方式的后续更新使用 ai-memory upgrade（校验和验证的 GitHub release 替换 + hook 刷新）。

核心亮点

用 Rust 实现，性能好、二进制分发方便，适合作为 CLI 常驻工具
解决跨会话记忆丢失的真实痛点，而非泛化的聊天记忆
支持不同智能体厂商之间的记忆交接，切工具不用重新交代项目背景

不足之处

项目较新，长期记忆的检索准确率和召回效果有待更多真实场景验证
生态集成广度未知，是否覆盖主流编程 CLI 需要看后续适配

适用场景

长期维护同一代码库，每天用 AI 编程助手但不想重复解释项目架构
在 Claude Code 和 Cursor 之间切换，希望延续之前的编码决策和待办
多人协作时让不同成员的 AI 助手共享同一份项目记忆

替代项目

mem0、Letta

上一篇：agentmemory

下一篇：feynman