tigerless-labs/agent-memory

这是什么？

核心功能

• 01Markdown 文件为唯一事实来源，SQLite 索引可删除后重建。
• 02基于 BM25 的本地检索，可选通过倒数排序融合接入向量检索。
• 03按层读取：从摘要、大纲、完整文件到原始引用消息逐级展开。
• 04会话边界自动写入，睡眠期整理合并记忆，删除操作需用户确认。
• 05Claude Code、Codex CLI、Muse Code 共享同一存储，并提供 MCP 服务器选项。
• 06支持按日期回溯查询，被替代的记忆保留在版本链中。

适用场景

• 让编程智能体跨会话保留项目决策和上下文。
• 在同一台机器上的多个智能体工具之间共享一套记忆存储。
• 将智能体记忆保存为可 grep、可用 git 管理的文件，便于迁移。
• 通过可选的 CJK 分词器，为中文记忆提供检索支持。

快速上手

1. 1

   克隆仓库

   git clone https://github.com/tigerless-labs/agent-memory.git
2. 2

   在仓库目录中使用 uv 安装依赖

   uv sync --all-packages
3. 3

   初始化记忆存储

   mem init
4. 4

   接入 Claude Code

   mem setup --host claude-code

使用前须知

• !目前尚未发布到 PyPI，因此必须从源码仓库安装。
• !需要 Python 3.12 或更高版本以及 uv。
• !当前版本为 0.1.0，较为早期；配置 Codex CLI 时可能需要额外的沙箱或信任确认。

收录于专题

标签

常见问题

agent-memory 是什么？

面向 AI 智能体的长期记忆运行时，以 Markdown 文件为唯一事实来源，本地检索，可在 Claude Code、Codex 等工具间共享，无需 API Key。 agent-memory 为 AI 智能体提供会话结束后仍然保留的长期记忆。记忆以 Markdown 文件形式存放在同一目录中，旁边的 SQLite 索引只是可随时重建的缓存，删除索引不会丢失任何知识。Claude Code、Codex CLI、Muse Code 以及任何能执行 shell 命令的工具都可以读写同一个存储。

agent-memory 可以免费使用吗？用的什么许可证？

agent-memory 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

agent-memory 还在维护吗？

活跃维护中。agent-memory 最近一次提交是在 2026年11月6日。

agent-memory 适合用来做什么？

让编程智能体跨会话保留项目决策和上下文。 在同一台机器上的多个智能体工具之间共享一套记忆存储。 将智能体记忆保存为可 grep、可用 git 管理的文件，便于迁移。 通过可选的 CJK 分词器，为中文记忆提供检索支持。

agent-memory 怎么安装和运行？

克隆仓库: git clone https://github.com/tigerless-labs/agent-memory.git 在仓库目录中使用 uv 安装依赖: uv sync --all-packages 初始化记忆存储: mem init 接入 Claude Code: mem setup --host claude-code

在哪里获取 agent-memory？

源代码和安装说明在 GitHub 上：https://github.com/tigerless-labs/agent-memory