gitmem

ドキュメント · npm · はじめに · ツールリファレンス

GitMem は、AI コーディングエージェントにセッションをまたいで持続する学習メモリを提供する MCP サーバーです。失敗（傷）、成功（成果）、判断を記憶するため、エージェントは毎回ゼロから始めるのではなく、経験から学べます。

MCP とは？ Model Context Protocol は、AI コーディングツールが外部機能に接続するためのプロトコルです。GitMem は MCP サーバーです。一度インストールすれば、エージェントに持続的なメモリが備わります。

Claude Code、Cursor、VS Code（Copilot）、Windsurf、および MCP 対応のあらゆるクライアントで動作します。

クイックスタート

npx gitmem-mcp init

コマンドは 1 つだけです。ウィザードが 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. 終了 — セッションの振り返りによって、次回のためのコンテキストが保存されます

すべての傷には反論が含まれています。これは、誰かがその教訓を無理なく無視できる理由です。これにより、メモリが融通の利かない規則の山になるのを防ぎます。

記憶される内容

主な機能

• 自動リコール — エージェントが同様のアクションを実行する前に、過去の失敗が表面化します
• セッションの継続性 — コンテキスト、スレッド、信頼関係をセッション間で引き継ぎます
• 終了セレモニー — 構造化された振り返りによって、何が壊れ、何がうまくいき、次回はどうすべきかを記録します
• 20 以上の MCP ツール — メモリ管理、検索、スレッド、マルチエージェント連携のための包括的なツールキット
• 設定不要 — 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 エージェントには、独自のメモリファイル（MEMORY.md、.cursorrules など）があるかもしれません。両者の連携方法は次のとおりです。

ヒント： 2 つのシステムを軽量につなぐには、.gitmem/agent-briefing.md を MEMORY.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 をご覧ください。