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 万星。

⭐ 18,423 Stars 🍴 1,523 Forks TypeScript Apache-2.0 作者: rohitg00
来源:README 顶部简介/Install/统计徽章、GitHub meta(rohitg00/agentmemory,TypeScript,Apache-2.0,homepage agent-memory.dev) 查看 GitHub 仓库 →

为什么值得关注

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

来源:README 统计/Benchmarks/Reproduce、GitHub meta(stars 16582、created_at 2026-02-25)

核心功能

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

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

来源:README Install/Works with every agent 段
置信度、生命周期、知识图谱与混合检索

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

来源:README 顶部(gist 扩展说明)/How It Works/vs Competitors 表
零外部数据库、本地免费 embedding

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

来源:README Benchmarks(embedding 说明)/vs Competitors(None: SQLite + iii-engine)
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 Install/MCP/Claude Code 集成段、统计徽章
实时查看器与可复现评测

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

来源:README Real-time viewer/Benchmarks/Reproduce 段、benchmark/COMPARISON.md 链接

技术架构

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 How It Works/MCP/各代理集成/Install、仓库目录树(src/packages/integrations/plugin/benchmark/eval/test)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 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 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言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 Install/How It Works/MCP/Configuration、packages 目录

快速上手

全局安装:`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 Install/Quick Start/Claude Code 集成段

使用场景

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

来源:README 顶部简介/Benchmarks/Works with every agent

优势与局限

优势

  • 零外部依赖、零 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 Benchmarks/各代理集成(Codex hooks 限制)/Configuration、统计来源

最新版本

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

来源:README Install/统计、benchmark 文档、GitHub meta pushed_at 2026-05-22、created_at 2026-02-25

总结评价

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

来源:综合 README、Benchmarks、How It Works 与 GitHub meta 的事实判断
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-23 19:27. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件