agentmemory 是什么?

agentmemory 是为 AI 编码代理提供持久记忆的开源工具,目标是让代理「记住一切、不用反复解释」。它以一个本地记忆服务器(默认 :3111)为核心,通过 hooks、MCP 或 REST 接入 Claude Code、Cursor、Gemini CLI、Codex、Hermes、OpenClaw、pi、OpenCode 等几乎所有支持这些机制的代理,所有代理共用同一记忆库。它构建在 iii engine 之上,把「记忆」做成带置信度评分、生命周期、知识图谱与混合检索的体系(README 称其实现了 Karpathy 的 LLM Wiki 模式的扩展)。零外部数据库(SQLite + iii-engine)、用本地免费 embedding,提供 53 个 MCP 工具、12 个自动 hook、950+ 测试。TypeScript、Apache-2.0、约 1.66 万星。

⭐ 24,494 Stars 🍴 2,015 Forks TypeScript Apache-2.0 作者: rohitg00 商业引流:中
来源:官方 README 与文档入口 查看 GitHub 仓库 →

为什么值得关注

编码代理「每个新会话都失忆、要重讲一遍上下文与约定」是普遍痛点,而现有记忆方案多依赖外部向量库或云服务、接入零散。agentmemory 把它做成一个零外部依赖(SQLite + 本地 embedding、$0 API 成本)、跨所有主流代理共享、并用基准数据说话的记忆层:README 给出 95.2% 的 R@5 检索、相对 grep 基线约 2.2× 精度、92% 更少 token,并提供可本地复现的评测 harness(LongMemEval 公开集 + 自建编码会话语料)与同类对比。这种「#1、可复现、零依赖、处处可用」的定位使它快速涨到约 1.66 万星。

来源:官方 README 与文档入口

核心功能

跨代理共享的持久记忆服务器

一个本地记忆服务器(:3111)被所有代理共用,通过 hooks、MCP 或 REST 接入 Claude Code、Cursor、Gemini CLI、Codex、Hermes、OpenClaw、pi、OpenCode 等;`agentmemory connect <agent>` 一键接线,多代理写入/读取同一份记忆。

来源:官方 README 与文档入口
置信度、生命周期、知识图谱与混合检索

记忆带置信度评分与生命周期管理,组织成知识图谱,并用混合检索(语义 + 关键词)召回;这是其在 LLM Wiki 模式上的扩展,用于让记忆既准又可治理。

来源:官方 README 与文档入口
零外部数据库、本地免费 embedding

存储用 SQLite + iii-engine,无需外部向量库;embedding 用本地 all-MiniLM-L6-v2(免费、无需 API key),整套可离线、零 API 成本运行。

来源:官方 README 与文档入口
53 个 MCP 工具与 12 个自动 hook

提供 53 个 MCP 工具(memory_smart_search、memory_save、memory_sessions、memory_governance_delete 等)与 12 个生命周期自动 hook(SessionStart/UserPromptSubmit/PreToolUse/PostToolUse/PreCompact/Stop 等),把记忆的写入与召回自动织进会话;Claude Code 有原生插件,插件市场一键装。

来源:官方 README 与文档入口
实时查看器与可复现评测

内置实时查看器(http://localhost:3113)可看记忆实时构建;附 eval/ 可插拔评测 harness,对 grep/向量/agentmemory 适配器在 LongMemEval 与自建语料上并排打分、输出 NDJSON 与公开 scorecard,并有与 mem0、Letta、Khoj、claude-mem、Hippo 的对比报告。

来源:官方 README 与文档入口

技术架构

agentmemory 是 TypeScript 实现、构建在 iii engine 之上的记忆系统。核心是一个本地 HTTP 记忆服务器(:3111),存储用 SQLite(零外部数据库),embedding 用本地 all-MiniLM-L6-v2,检索为语义+关键词混合,记忆带置信度评分、生命周期与知识图谱组织。仓库为单仓多包:src/(核心)、packages/(如 @agentmemory/agentmemory CLI 与 @agentmemory/mcp 的 MCP 服务器)、integrations/(各代理接入:openclaw/hermes/pi 等)、plugin/ 与 .claude-plugin/.codex-plugin/(原生插件)、benchmark/ 与 eval/(评测)、website/、docs/、deploy/、examples/、test/(950+ 测试)。接入方式三选一:hooks(生命周期自动观察)、MCP(@agentmemory/mcp 暴露 53 工具,连不到服务器时本地降级到 7 工具)、REST API。Claude Code 经插件市场装后自动注册 12 hooks + 4 skills + MCP;可用 AGENTMEMORY_URL/SECRET 指向远程/受保护部署。

来源:官方 README 与文档入口

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) iii engine(底层引擎)iii engine(底… SQLite(存储,零外部 DB)SQLite(存储,… all-MiniLM-L6-v2(本地 embedding,免费)all-MiniLM-L6-… MCP(@agentmemory/mcp,53 工具)+ hooks + RESTMCP(@agentmem… 跨代理共享的持久记忆服务器跨代理共享的持久记忆服… 置信度、生命周期、知识图谱与混合检索置信度、生命周期、知识… 零外部数据库、本地免费 embedding零外部数据库、本地免费… 53 个 MCP 工具与 12 个自动 hook53 个 MCP 工具与 12… 实时查看器与可复现评测 agentmemory 项目本体 核心功能 关键依赖

技术栈

语言TypeScript框架iii engine 之上的记忆系统 + 本地 HTTP 服务器
iii engine(底层引擎)SQLite(存储,零外部 DB)all-MiniLM-L6-v2(本地 embedding,免费)MCP(@agentmemory/mcp,53 工具)+ hooks +…
npm 包 @agentmemory/agentmemory,本地服务器 :3111、查看器 :3113;可离线、$0 API 成本;支持远程/受保护部署(AGENTMEMORY_URL/SECRET)
来源:官方 README 与文档入口

快速上手

全局安装:`npm install -g @agentmemory/agentmemory`(macOS/Linux 遇 EACCES 可加 sudo),然后 `agentmemory` 启动记忆服务器(:3111),`agentmemory demo` 灌入样例并验证召回,`agentmemory connect claude-code`(或 codex/cursor/gemini-cli 等)接线你的代理。也可免安装 `npx @agentmemory/agentmemory`(注意 npx 缓存,必要时用 @latest 或清 _npx 缓存)。Claude Code 还可经插件市场:起服务后 `/plugin marketplace add rohitg00/agentmemory` 与 `/plugin install agentmemory`,自动注册 12 hooks、4 skills 与 MCP(53 工具)。用 `curl http://localhost:3111/agentmemory/health` 验证,实时查看器在 http://localhost:3113。
来源:官方 README 与文档入口

使用场景

适合中重度使用 AI 编码代理的开发者与团队,想让代理跨会话、跨工具记住项目约定、决策、踩坑与上下文,免去反复解释:在 Claude Code/Cursor/Codex 等之间共享同一记忆库、自动召回相关记忆并大幅省 token;用知识图谱与置信度让记忆可治理(删除/淘汰);离线、零外部 DB、零 API 成本地自托管。也适合想评测/对比各记忆方案的人(用其可复现 harness),或作为「如何为代理做持久记忆」的参考实现。

来源:官方 README 与文档入口

优势与局限

优势

  • 零外部依赖、零 API 成本:SQLite + 本地 embedding,可离线运行,部署与隐私友好。
  • 跨代理通用:一个服务器经 hooks/MCP/REST 服务几乎所有主流编码代理,53 MCP 工具 + 12 自动 hook,接入便捷。
  • 用数据说话且可复现:公开基准(R@5 95.2%、相对 grep 约 2.2× 精度、92% 省 token)与可本地复现的评测 harness、同类对比报告。
  • 工程成熟:950+ 测试、实时查看器、记忆生命周期与知识图谱、Claude Code 原生插件,Apache-2.0 开源。

局限

  • 基准多由项目自身给出(含自建语料),「#1」等表述需结合 LongMemEval 等公开集与自身场景复核。
  • 需常驻本地记忆服务器并接线各代理,且部分能力依赖宿主代理的 hooks/MCP 支持(如 Codex Desktop 当前不派发插件本地 hooks,仅 MCP 工具可用)。
  • 依赖 iii engine 与特定 embedding 模型,深度定制或更换组件有一定成本。
  • 记忆质量与召回仍受 embedding/检索与写入策略影响,跨项目记忆的治理与隐私需谨慎配置。
来源:官方 README 与文档入口

最新版本

以 npm 包 @agentmemory/agentmemory(及 @agentmemory/mcp)持续发布,配 CI 与 950+ 测试,Claude Code 经插件市场分发。功能已覆盖跨代理记忆服务器、53 MCP 工具、12 自动 hook、知识图谱、置信度与生命周期、混合检索、实时查看器与可复现评测。最近一次更新在 2026-05-22。

来源:官方 README 与文档入口

总结评价

agentmemory 把「让编码代理拥有持久、可治理、跨工具共享的记忆」这件事做得相当完整:一个零外部依赖、零 API 成本的本地服务器,经 hooks/MCP/REST 服务几乎所有主流代理,配知识图谱、置信度、生命周期与混合检索,还用公开+自建基准和可复现 harness 来证明效果。对天天用 Claude Code/Cursor/Codex、苦于反复解释上下文的开发者,它能带来实打实的省心与省 token,工程与生态也成熟。要理性看待的是「#1」等结论以项目自评为主、需自行复核,且要常驻服务器、部分能力受宿主代理 hooks/MCP 支持限制。作为「给编码代理装一套本地长期记忆」的基础设施,它的完成度和数据透明度都很突出。

来源:官方 README 与文档入口
资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-05-23 19:27.

参考材料:README、GitHub API、依赖文件