gitmem

文档 · npm · 快速入门 · 工具参考

GitMem 是一个 MCP 服务，可为你的 AI 编码 Agent 提供跨 Agent 会话的持久学习记忆。它会记住错误（伤痕）、成功（胜利）和决策，让你的 Agent 能从经验中学习，而不是每次都从头开始。

什么是 MCP？ Model Context Protocol 是 AI 编码工具连接外部能力的方式。GitMem 是一个 MCP 服务——安装一次，你的 Agent 就能获得持久记忆。

适用于 Claude Code、Cursor、VS Code (Copilot)、Windsurf 以及任何兼容 MCP 的客户端。

快速入门

npx gitmem-mcp init

一条命令即可完成。向导会自动检测你的 IDE 并完成所有设置：

• 包含初始伤痕的 .gitmem/ 目录
• MCP 服务配置（.mcp.json、.vscode/mcp.json、.cursor/mcp.json 等）
• 指令文件（CLAUDE.md、.cursorrules、.windsurfrules、.github/copilot-instructions.md）
• 生命周期钩子（在支持的环境中）
• 更新 .gitignore

已有配置？向导会合并配置，不会破坏任何内容。可以安全地重复运行。

npx gitmem-mcp init --yes                # Non-interactive
npx gitmem-mcp init --dry-run            # Preview changes
npx gitmem-mcp init --client vscode      # Force specific client

工作原理

recall  -->  work  -->  learn  -->  close  -->  recall  -->  ...

1. 回忆 — 开始行动前，Agent 会检查记忆，查找以往会话中的相关经验
2. 工作 — Agent 执行任务，并自动应用过去的经验
3. 学习 — 错误会成为伤痕，成功会成为胜利，策略会成为模式
4. 收尾 — 会话反思会保存上下文，供下次使用

每条伤痕都包含反驳理由——说明为什么有人可能会合理地忽略它。这可以避免记忆变成一堆僵化的规则。

会记住哪些内容

主要功能

• 自动回想 — Agent 采取类似行动前，会先呈现相关教训
• 会话连续性 — 上下文、线程和默契会延续到后续会话
• 收尾仪式 — 通过结构化反思记录哪些出了问题、哪些奏效，以及下次该如何改进
• 20+ 个 MCP 工具 — 提供完整工具集，用于记忆管理、搜索、线程和多 Agent 协作
• 零配置 — 运行 npx gitmem-mcp init 即可开始使用
• 非破坏性 — 与现有的 .mcp.json、CLAUDE.md 和钩子合并

支持的客户端

向导会自动检测你的 IDE。使用 --client 可覆盖此设置。

{
  "mcpServers": {
    "gitmem": {
      "command": "npx",
      "args": ["-y", "gitmem-mcp@latest"]
    }
  }
}

CLI 命令

Pro 版本

在你自己的 Supabase 上自托管。基础设施由你提供，gitmem 负责设置。

快速开始

npx supabase login                                          # one time
export SUPABASE_URL="https://yourproject.supabase.co"
export SUPABASE_SERVICE_ROLE_KEY="eyJ..."
export OPENROUTER_API_KEY="sk-or-v1-..."
npx gitmem-mcp activate <your-license-key>

activate 命令会自动创建所有表、视图、RPC 函数和索引。无需手动执行 SQL。

完整指南请参阅 docs/pro-setup-guide.md。

免费版为个人项目提供所有功能。Pro 版让回想更智能、记忆更便于迁移。

GitMem + MEMORY.md

你的 AI Agent 可能有自己的记忆文件（MEMORY.md、.cursorrules 等）。以下是它们的协作方式：

提示： 在 MEMORY.md 中加入 .gitmem/agent-briefing.md，即可轻松衔接这两个系统。

隐私与数据

• 本地优先 — 默认情况下，所有数据都存储在你机器上的 .gitmem/ 中
• 无遥测 — GitMem 不会收集使用数据，也不会向外发送数据
• 云端需主动启用 — Pro 套餐的 Supabase 后端需要通过环境变量显式配置
• 你的数据 — 会话、伤痕和决策都归你所有。删除 .gitmem/ 即可移除所有内容

开发

git clone https://github.com/gitmem-dev/gitmem.git
cd gitmem
npm install
npm run build
npm test

请参阅 CONTRIBUTING.md，了解完整的开发环境设置。

许可证

MIT — 请参阅 LICENSE。