开源 | 我是怎么用 ai-memory 让 Cursor 每次开新对话都自动知道项目背景的

开源 | 我是怎么用 ai-memory 让 Cursor 每次开新对话都自动知道项目背景的开源地址https://github.com/hyxnj666-creator/ai-memorynpmnpx ai-memory-clilatest内置免费模型无需配置 API Key协议MIT先说痛点用 Cursor 做过多项目的人应该都有这个体验每次开新会话要花 5-15 分钟重新铺背景。“这个项目用的是 PostgreSQL当时选它是因为……”、“上次那个 Redis 方案我们讨论过不用原因是……”、“这个模块正在重构不要动里面的逻辑……”AI 永远是新的。记忆永远是你自己扛。我在 Cursor 里积累了 37 个对话窗口涉及将近 20 个项目。直到有一天跑了一次 ai-memory把这些对话提取成了519 条结构化记忆才发现里面藏着多少沉没的知识。从那之后我把 ai-memory 变成了日常开发工作流的一部分。这篇文章分享一下我现在的具体做法。我现在的工作流第一步周期性提取增量模式我在本机注册了一个每天自动跑的定时任务npx ai-memory-cli init--schedule这样每天早上 9 点工具自动扫描新增的 Cursor 对话增量提取不用手动触发。如果要手动跑一次# 增量模式只处理新增对话已提取的跳过npx ai-memory-cli extract--incremental第二步提取后同步 AGENTS.md提取完之后我会更新一下 AGENTS.mdnpx ai-memory-cli rules--targetagents-md这个文件会被 Cursor、Claude Code、Windsurf、Copilot、Codex CLI 在每次新会话时自动读取。AI 打开对话就已经知道这个项目的架构、决策、禁区——不需要你再解释一遍。生成的 AGENTS.md 大概长这样## Architecture Decisions - Use PostgreSQL (not MongoDB) — chosen for ACID compliance in billing module - Event Sourcing for audit log — append-only, immutable history required ## Conventions - All API routes use snake_case - No direct DB access from route handlers — always go through repos ## Off-limits - Do not refactor /src/legacy/ — scheduled for Q3, currently frozenAI 读到这些就不会再犯帮你把 MongoDB 换成 PostgreSQL或者顺手重构了一下你说不要动的模块这类问题。第三步开新会话时加载上下文如果某个功能需要某个特定对话的背景我会用 context 命令把那段记忆复制进去# 把最近的记忆复制到剪贴板npx ai-memory-cli context--copy# 只加载某一个对话的记忆npx ai-memory-cli context --source-id e0ef3946--copy粘贴到新会话的开头AI 立刻有了完整上下文。第四步搜索历史决策三个月前做过一个技术选型现在突然想起来当时的结论是什么npx ai-memory-cli recallOAuth不仅能找到相关决策还能看到这条记忆在 git 历史中每次被修改的轨迹——什么时候做的决定后来有没有改过谁改的。Dashboard 可视化npx ai-memory-cli dashboard浏览器打开http://localhost:3141可以看到所有记忆的分布、时间线、每个对话的产出量。提取的 5 种记忆类型ai-memory 会把对话内容分成 5 类类型说明示例Decision技术选型、架构决策“决定用 PostgreSQL 而不是 MongoDB”Architecture系统架构设计“用 Event Sourcing 实现账单审计日志”Convention编码规范、命名约定“所有 API 使用 snake_case 命名”TODO待完成任务“需要补充 OAuth 错误处理”Issue发现的 bug 或问题“AGENTS.md 输出字段重复”每条是一个独立的 Markdown 文件放在.ai-memory/{author}/{type}/下完全可以用git diff追踪变化。支持的编辑器编辑器状态Cursor✅Claude Code✅Windsurf✅VS Code Copilot Chat✅OpenAI Codex CLI✅零配置直接跑不用配 API Key内置免费模型DeepSeek-V4-Flash限 2 个对话/次体验完整流程够用npx ai-memory-cli try# 试用不修改任何文件npx ai-memory-cli extract# 直接提取大批量提取推荐硅基流动500 条记忆约 ¥0.1或者 Ollama 完全本地跑exportAI_REVIEW_API_KEYsk-...# OPENAI_BASE_URLhttps://api.siliconflow.cn/v1开源信息GitHubhttps://github.com/hyxnj666-creator/ai-memorynpmhttps://www.npmjs.com/package/ai-memory-cli版本v2.6持续迭代中协议MIT License如果你也在用 Cursor / Claude Code 开发欢迎试试有问题直接提 Issue。