你是否也经历过这样的困扰:每次让 AI 编程助手(比如 Cursor 或 Claude Code)修改一个模块,它都像第一次见你一样,反复问“这个函数是干啥的?”“项目用的是什么框架?”——不是它笨,而是它没有“记忆”。agentmemory 正是为解决这一痛点而生:它是首个专为 AI 编程代理设计的轻量级、持久化、可插拔的记忆系统,让 AI 真正记住你的代码风格、项目结构、历史决策和关键约定,告别重复解释、减少上下文冗余、显著提升长周期协作效率。
核心功能
- 跨会话持久记忆:自动将代码理解、用户反馈、调试日志等结构化存入本地向量数据库(默认 SQLite + LanceDB),重启 IDE 或切换任务后记忆依然可用
- 多工具无缝集成:原生支持 Claude Code、Cursor、Gemini CLI、Codex CLI、pi、OpenCode 等主流 AI 编程客户端,同时兼容任何遵循 MCP(Model Context Protocol) 标准的客户端
- 智能知识图谱建模:不止存储文本片段,还能自动构建函数调用链、模块依赖关系、错误修复路径等语义关联,让 AI “理解”而非“背诵”
- 混合检索增强(Hybrid Search):融合关键词匹配、语义向量搜索与置信度加权排序,确保在千行代码中精准召回最相关的上下文片段
- 生命周期管理:支持记忆老化(TTL)、人工标注重要性、冲突版本合并,避免“记忆过载”或“张冠李戴”
- 零配置快速启动:开箱即用,无需部署向量数据库服务;高级用户也可对接 Pinecone、Weaviate 或本地 Chroma
适合哪些人用
如果你是以下角色之一,agentmemory 将极大提升你的 AI 协作体验:前端/全栈工程师(维护多个 React/Vue 项目时保持组件命名与状态管理一致性);开源贡献者(在 PR 评审中让 AI 快速回顾历史讨论与架构演进);技术团队 Leader(为新成员配置统一的项目认知基线,降低上手成本);以及AI 工具开发者(基于其 TypeScript SDK 快速为自研 Agent 添加企业级记忆能力)。
快速上手

只需三步即可启用:
- 安装 npm 包:
npm install @agentmemory/agentmemory - 在你的 AI 客户端插件或 MCP 服务中初始化(示例):
import { AgentMemory } from "@agentmemory/agentmemory";
const memory = new AgentMemory({ projectId: "my-app" });
await memory.store("user_requirement", "需兼容 IE11,禁用 ES6+ 语法"); - 在后续请求中调用
memory.search("IE11 兼容要求")即可获取带置信分的上下文结果
详细 API 文档与 Cursor/Claude Code 插件集成指南见 GitHub README。首次运行自动创建 .agentmemory/ 目录,所有数据默认本地存储,隐私可控。
项目信息
#1 Persistent memory for AI coding agents based on real-world benchmarks
3.2k
今日 +518 stars today
Stars
322
Forks
TypeScript
Apache-2.0
TypeScript | ⭐ 3152 Stars | Apache-2.0 开源协议 | GitHub 项目地址
这不是又一个玩具 Demo——它已通过真实编码基准测试验证,在 12 个典型开发场景中平均减少 63% 的重复上下文注入,让 AI 编程从“单次问答”真正迈向“持续协作”。




