= 18" />
Documentation · npm · Getting Started · Tool Reference
______________________________________________________________________
GitMem 是 MCP服务器 这给了你的AI编码代理 跨代理会话的持久学习记忆它会记住错误（疤痕）、成功（胜利）和决定——这样你的代理人就可以从经验中学习，而不是每次都从头开始。
什么是MCP？ 模型上下文协议 是AI编码工具如何连接到外部功能。GitMem是一个MCP服务器——安装一次，你的代理就会获得持久内存。
使用 克劳德代码, 光标, VS代码（副本）, 帆板运动，以及任何兼容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 --> ...- 召回 --在采取行动之前，代理会检查记忆中过去会话的相关教训
- 工作 --代理执行任务，自动应用过去的课程
- 学习 --错误变成 伤疤，成功成为 胜利，战略成为 模式
- 关闭 --会话反射为下次保留上下文
每一道疤痕都包括 反驳 --有人可能会合理地忽略它的原因。这可以防止记忆变成一堆僵化的规则。
什么会被记住
| 类型 | 目的 | 示例 |
|---|---|---|
| 伤痕 | 要避免的错误 | “在数据库查找之前始终验证UUID格式” |
| 胜利 | 有效的方法 | “并行代理生成将审查时间缩短了60%” |
| 模式 | 可重用策略 | “MCP服务器的5层测试金字塔” |
| 决策 | 基于逻辑的架构选择 | “选择JWT而不是会话Cookie进行无状态身份验证” |
| 线程 | 跨会话未完成的工作 | “限速仍需实施” |
主要特点
- 自动召回 --在代理采取类似行动之前，疤痕会浮出水面
- 会话连续性 --上下文、线索和融洽关系贯穿整个会话
- 闭幕式 --结构化反思捕捉到了什么失败了，什么奏效了，以及应该采取什么不同的做法
- 20+MCP工具 --用于内存管理、搜索、线程和多代理协调的完整工具包
- 零配置 —
npx gitmem-mcp init而你正在奔跑 - 无损检测 --与您现有的合并
.mcp.json,CLAUDE.md，和钩子
支持的客户
| 客户端 | 设置 | 挂钩 |
|---|---|---|
| 克劳德代码 | npx gitmem-mcp init | 完整（会话、召回、凭证保护） |
| 光标 | npx gitmem-mcp init --client cursor | 部分（会话、召回） |
| VS代码（副本） | npx gitmem-mcp init --client vscode | 基于指令 |
| 帆板运动 | npx gitmem-mcp init --client windsurf | 基于指令 |
| 克劳德桌面 | 添加到 claude_desktop_config.json | 手册 |
| 任何MCP客户端 | npx gitmem-mcp init --client generic | 基于指令 |
向导会自动检测您的IDE。使用 --client 以覆盖。
Manual MCP configuration
将以下内容添加到MCP客户端的配置文件中：
{
"mcpServers": {
"gitmem": {
"command": "npx",
"args": ["-y", "gitmem-mcp"]
}
}
}| 客户端 | 配置文件 |
|---|---|
| 克劳德代码 | .mcp.json |
| 光标 | .cursor/mcp.json |
| VS代码 | .vscode/mcp.json |
| 风帆冲浪 | ~/.codeium/windsurf/mcp_config.json |
CLI命令
| 命令 | 描述 |
|---|---|
npx gitmem-mcp init | 交互式设置向导（自动检测IDE） |
npx gitmem-mcp init --client | 针对特定客户端的设置(claude, cursor, vscode, windsurf, generic) |
npx gitmem-mcp init --yes | 非交互式设置 |
npx gitmem-mcp init --dry-run | 预览更改 |
npx gitmem-mcp uninstall | 清洁去除（保存 .gitmem/ 数据） |
npx gitmem-mcp uninstall --all | 完全删除，包括数据 |
npx gitmem-mcp check | 诊断健康检查 |
Pro Tier即将推出
| 你得到了什么 | 为什么你的经纪人关心 |
|---|---|
| 语义搜索 | Recall返回 *正确的* 疤痕，而不是关键字噪音 |
| 会话分析 | 找出问题所在 |
| 次级代理简报 | 自动将机构背景传递给子代理 |
| 云持久性 | 内存可以在机器更改后幸存下来，可以在团队中共享 |
| A/B测试分析 | 衡量哪些疤痕措辞实际上改变了代理行为（自由层包括 GITMEM_NUDGE_VARIANT 用于手动测试） |
免费版为您的个人项目提供了一切。Pro使回忆更智能，记忆更便携。
加入邮件列表 以获得通知。
GitMem + 内存.md
您的AI代理可能有自己的内存文件（memory.md、.cursorules等）。以下是它们如何协同工作：
| MEMORY.md | GitMem | |
|---|---|---|
| 已加载 | 每次转弯（系统提示） | 按需（工具调用） |
| 最适合 | 偏好、快捷方式、快速参考 | 吸取的教训、未完成的工作、决定 |
| 更新 | 代理直接写入 | 会话生命周期（结束仪式） |
| 示例 | “用户更喜欢简洁的输出” | “在数据库查找之前始终验证UUID” |
提示： 包含 .gitmem/agent-briefing.md 在MEMORY.md中，您可以在两个系统之间建立轻量级的桥梁。
隐私和数据
- 本地优先 --所有数据存储在
.gitmem/默认情况下在您的计算机上 - 无遥测 --GitMem不收集使用数据或致电主页
- 云选择加入 --Pro tier Supabase后端需要通过环境变量进行显式配置
- 您的数据 --会议、疤痕和决定都属于你。删除
.gitmem/删除所有内容
发展
git clone https://github.com/gitmem-dev/gitmem.git
cd gitmem
npm install
npm run build
npm test看 贡献.md 用于完整的开发设置。
许可证
麻省理工学院——见 许可证.