今天介绍的是一个给现有编码助手补长期记忆的本地记忆服务。

agentmemory
agentmemory 是 rohitg00 做的一个 TypeScript 开源项目,给 AI 编码代理提供持久记忆,解决每次新会话失忆的情况。
比如维护一个中型后端服务,认证、限流、审计、部署脚本都已经定过规矩。
今天你在 Claude Code 里让它改登录流程,明天切到 Cursor 里补测试,后天又在 Codex CLI 里修 CI。
每次开始都得重新解释认证走哪套中间件、哪些目录不能碰、哪个历史坑已经踩过、为什么某个依赖不能升级。
传统做法一般就两种:要么把这些信息塞进一个超长规则文件,要么每次复制旧对话里的关键段落。
前者会过期,后者很浪费 token,而且你自己都未必找得到。
agentmemory 它不是替代 Agent,而是变成 Agent 背后的长期记忆层。

它会静默捕获代理做过的事,压缩成可搜索的记忆,再在下次会话启动时注入最相关的上下文。
支持接入Claude Code、Cursor、Gemini CLI、Codex CLI、OpenCode、Aider,以及任何支持 MCP 或 HTTP 的 Agent。
1. 在多个编码助手之间共享同一份项目记忆
很多人现在的工作流已经变成了在 Cursor 里边看边改,在 Claude Code 里做长链路重构,在 Codex CLI 或 Gemini CLI 里跑命令式任务。
问题是这些工具各有会话上下文,但项目知识并不共享,换一个入口,就得重新解释一下。
agentmemory 的处理方式是把所有 Agent 连接同一个记忆服务器。
只要工具支持 hook、MCP 或 REST API,它就能接进来。
Claude Code 和 Codex CLI 支持 hook + MCP + skills,Cursor、Gemini CLI、Cline、Windsurf 这类则主要通过 MCP 服务接入,Aider 走 REST API。

将不同agent链接后,就不再是每个工具各自存一份摘要,而是同一个项目记忆被多个入口共用。
你今天在 Claude Code 里形成的项目约定,明天在 Cursor 里也能被检索到。

很多同类项目要么是完整 Agent 运行时,要你换工作流;要么只是一个记忆 API,不直接贴近编码场景。
agentmemory 则更像一个独立记忆中间层,你保留原来的工具,只补上记忆能力。
2. 把长上下文压缩成可检索记忆
另一个更现实的场景是上下文越来越长,AI 越来越贵,也越来越不稳定。
一般在干活之前为了让 Agent 不犯低级错,开头先贴一大段架构说明、目录结构、历史决策、代码规范,再补几条注意不要改这里。
结果这段提示词越来越长,改一次项目就要更新一次,可能到最后自己都懒得维护。
agentmemory 不是把整段上下文原封不动塞回去,而是做捕获 -> 压缩 -> 检索 -> 注入。

它有两组很亮眼的数据:
LongMemEval-S 上检索准确率 R@5 为 95.2%,同时宣称相比手工粘贴完整上下文,年度 token 可从 1950 万级降到 17 万左右;如果本地跑向量模型 `all-MiniLM-L6-v2`,嵌入成本还可以做到 0 API Key。简单点就是它不让模型每次都重新吃完整项目史,而是只喂这次最相关的那部分记忆。
3. 提供可观察、可管理的服务形态
很多记忆项目最后的问题不是不能存,而是你不知道它到底存了什么、删了什么、什么时候注入过。
agentmemory 在这块做得比我预期完整。
它不是单纯一组 SDK,而是带 MCP server、实时查看器(real-time viewer)、iii Console,以及 100+ REST API endpoint。
并且独立 MCP 会代理到正在运行的主服务,这样 hooks、viewer 看到的是同一份状态;

另外删除路径加了统一审计策略,health 检查也调整过,避免在小 Node 进程里频繁报 memory_critical。
同时强调 0 external DBs,也就是不依赖外部数据库,这对个人开发者和小团队挺重要,不用一上来就要配 PG、向量库、Redis 一整套。
上手体验
npx @agentmemory/agentmemory执行这条命令后,启动本地的记忆服务器。
接下来的接入方式,大致分三类:
对 Cursor、Claude Desktop、Windsurf、Cline 这类支持 MCP 的工具,需要把 agentmemory 当作一个 MCP 服务注册进去。也就是让这些工具知道:有一台本地服务专门负责记忆读写。
对 Claude Code、Codex CLI 这种 README 标明支持 hooks 的工具,可以利用 hook 自动捕获会话中的关键信息。这里的 hook 可以理解成在某些动作发生时自动触发保存记忆。
对 Aider 或其他 HTTP 客户端,则走 REST API。
开源地址:https://github.com/rohitg00/agentmemory如果你也对这类前沿开源项目感兴趣,想第一时间看到真正有潜力的 GitHub 热门项目解析,关注本公众号。
后面我还会继续挖更多值得收藏、值得实操、值得思考的开源好东西。
夜雨聆风