Repolode
rohitg00

rohitg00/agentmemory

为 Claude Code、Cursor、Codex 等 AI 编程助手提供持久化记忆,自动记录会话并在新会话中注入相关上下文。

Star
29,683
Fork
2,621
未关闭 Issue
582
最近提交
12小时前

这是什么?

agentmemory 是一个面向 AI 编程助手的记忆服务。它在会话过程中自动记录智能体的操作,把这些观察压缩成可检索的记忆,并在下一次会话开始时注入相关上下文,开发者不必每次重复解释架构、历史 bug 或个人偏好。

项目基于 iii 引擎和 SQLite 在本地运行,无需外部数据库。检索结合了 BM25 关键词搜索、可选的本地向量嵌入(all-MiniLM-L6-v2)以及图谱匹配;未配置嵌入服务时可以无密钥运行,此时使用 BM25。它提供 54 个 MCP 工具和 REST API,并带有实时查看器与会话回放功能。

支持 Claude Code、Codex CLI、GitHub Copilot CLI、Cursor、Gemini CLI、OpenClaw、Hermes、OpenCode 等多种支持 MCP 或 Hook 的工具,所有客户端共享同一个记忆服务。

核心功能

  • 01通过生命周期 Hook 自动捕获智能体操作,无需手动保存。
  • 02混合检索,结合 BM25、可选的本地向量嵌入与图谱匹配。
  • 03提供 54 个 MCP 工具和 REST API,适配任何兼容 MCP 的客户端。
  • 04基于 SQLite 和 iii 引擎在本地运行,不依赖外部数据库。
  • 05内置实时查看器,支持会话回放和 Claude Code JSONL 记录导入。

适用场景

  • 在使用 Claude Code 或 Cursor 持续开发数天的项目中保留架构与历史决策。
  • 让同一代码库上使用的多个编程助手共享一个记忆库。
  • 无需手动粘贴笔记,即可回忆之前修复过的 bug 和团队约定。
  • 回放并审查智能体在过往会话中的操作。

快速上手

  1. 1

    运行交互式安装并启动记忆服务器

    npx -y @agentmemory/agentmemory@latest
  2. 2

    写入示例会话并测试召回

    npx -y @agentmemory/agentmemory@latest demo
  3. 3

    为你的代理安装17个原生技能

    npx skills add rohitg00/agentmemory -y

使用前须知

  • 原生 Windows 需要手动安装固定版本 iii-engine v0.22.1,WSL2 或 Docker Desktop 更简便。
  • 无密钥模式会禁用向量嵌入,除非配置本地或其他嵌入提供方,否则召回依赖 BM25。
  • 在 macOS/Linux 上自动安装 iii-engine 需要 curl、sh 和 tar,精简镜像可能缺少这些工具。
  • 项目固定使用 iii-engine v0.22.1,无法与其他版本的自装 iii 引擎配合使用。

标签

常见问题

agentmemory 是什么?
为 Claude Code、Cursor、Codex 等 AI 编程助手提供持久化记忆,自动记录会话并在新会话中注入相关上下文。 agentmemory 是一个面向 AI 编程助手的记忆服务。它在会话过程中自动记录智能体的操作,把这些观察压缩成可检索的记忆,并在下一次会话开始时注入相关上下文,开发者不必每次重复解释架构、历史 bug 或个人偏好。
agentmemory 可以免费使用吗?用的什么许可证?
agentmemory 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
agentmemory 还在维护吗?
活跃维护中。agentmemory 最近一次提交是在 2026年10月19日。
agentmemory 适合用来做什么?
在使用 Claude Code 或 Cursor 持续开发数天的项目中保留架构与历史决策。 让同一代码库上使用的多个编程助手共享一个记忆库。 无需手动粘贴笔记,即可回忆之前修复过的 bug 和团队约定。 回放并审查智能体在过往会话中的操作。
agentmemory 怎么安装和运行?
运行交互式安装并启动记忆服务器: npx -y @agentmemory/agentmemory@latest 写入示例会话并测试召回: npx -y @agentmemory/agentmemory@latest demo 为你的代理安装17个原生技能: npx skills add rohitg00/agentmemory -y
在哪里获取 agentmemory?
源代码和安装说明在 GitHub 上:https://github.com/rohitg00/agentmemory

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目