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 万星。
来源: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
记忆带置信度评分与生命周期管理,组织成知识图谱,并用混合检索(语义 + 关键词)召回;这是其在 LLM Wiki 模式上的扩展,用于让记忆既准又可治理。
来源:README 顶部(gist 扩展说明)/How It Works/vs Competitors 表存储用 SQLite + iii-engine,无需外部向量库;embedding 用本地 all-MiniLM-L6-v2(免费、无需 API key),整套可离线、零 API 成本运行。
来源:README Benchmarks(embedding 说明)/vs Competitors(None: SQLite + iii-engine)提供 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)中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成
iii engine(底层引擎)SQLite(存储,零外部 DB)all-MiniLM-L6-v2(本地 embedding,免费)MCP(@agentmemory/mcp,53 工具)+ hooks +…适合中重度使用 AI 编码代理的开发者与团队,想让代理跨会话、跨工具记住项目约定、决策、踩坑与上下文,免去反复解释:在 Claude Code/Cursor/Codex 等之间共享同一记忆库、自动召回相关记忆并大幅省 token;用知识图谱与置信度让记忆可治理(删除/淘汰);离线、零外部 DB、零 API 成本地自托管。也适合想评测/对比各记忆方案的人(用其可复现 harness),或作为「如何为代理做持久记忆」的参考实现。
来源:README 顶部简介/Benchmarks/Works with every agent以 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-25agentmemory 把「让编码代理拥有持久、可治理、跨工具共享的记忆」这件事做得相当完整:一个零外部依赖、零 API 成本的本地服务器,经 hooks/MCP/REST 服务几乎所有主流代理,配知识图谱、置信度、生命周期与混合检索,还用公开+自建基准和可复现 harness 来证明效果。对天天用 Claude Code/Cursor/Codex、苦于反复解释上下文的开发者,它能带来实打实的省心与省 token,工程与生态也成熟。要理性看待的是「#1」等结论以项目自评为主、需自行复核,且要常驻服务器、部分能力受宿主代理 hooks/MCP 支持限制。作为「给编码代理装一套本地长期记忆」的基础设施,它的完成度和数据透明度都很突出。
来源:综合 README、Benchmarks、How It Works 与 GitHub meta 的事实判断