AI导哈

AI编程代理记忆服务

GitMem是一个为AI编程代理提供跨会话持久学习记忆的MCP服务器，通过记录错误、成功和决策帮助代理从经验中学习。

  • by gitmem-dev
  • TypeScript
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 gitmem-dev/gitmem

使用说明

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  -->  ...
  1. 召回 --在采取行动之前，代理会检查记忆中过去会话的相关教训
  2. 工作 --代理执行任务，自动应用过去的课程
  3. 学习 --错误变成 伤疤，成功成为 胜利，战略成为 模式
  4. 关闭 --会话反射为下次保留上下文

每一道疤痕都包括 反驳 --有人可能会合理地忽略它的原因。这可以防止记忆变成一堆僵化的规则。

什么会被记住

类型 目的 示例
伤痕 要避免的错误 “在数据库查找之前始终验证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@latest"]
    }
  }
}
客户端 配置文件
克劳德代码 .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 <name> 针对特定客户端的设置(claude, cursor, vscode, windsurf, generic)
npx gitmem-mcp init --yes 非交互式设置
npx gitmem-mcp init --dry-run 预览更改
npx gitmem-mcp activate <key> 激活Pro层（自动应用架构）
npx gitmem-mcp deactivate 删除Pro凭据，释放设备插槽
npx gitmem-mcp setup 输出模式SQL（用于手动设置Supabase）
npx gitmem-mcp uninstall 清洁去除（保存 .gitmem/ 数据）
npx gitmem-mcp uninstall --all 完全删除，包括数据
npx gitmem-mcp check 诊断健康检查

专业级别

自行托管在您自己的Supabase上。你带来基础设施，gitmem来设置它。

你得到了什么 为什么你的经纪人关心
语义搜索 Recall返回 正确的 疤痕，而不是关键字噪音
会话分析 找出问题所在
次级代理简报 自动将机构背景传递给子代理
云持久性 内存可以在机器更改后幸存下来，可以在团队中共享
A/B测试分析 衡量哪些疤痕措辞实际上改变了代理人的行为

快速开始

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 + 内存.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 用于完整的开发设置。

许可证

麻省理工学院——见 许可证.

相关 MCP