repomemory

npx repomemory go

問題点

Claude Code、Cursor、Copilot などの AI コーディングエージェントでプロジェクトを開くたびに、次のことが起こります。

• アーキテクチャをゼロから再発見します
• すでに議論され、却下された変更を提案します
• すでに修正されたバグを再び持ち込みます

CLAUDE.md / .cursorrules は役立ちますが、静的で古くなってしまいます。

解決策

.context/
├── index.md              ← Quick orientation (loaded every session)
├── facts/                ← Architecture, database, deployment
├── decisions/            ← "We chose Drizzle over Prisma because..."
├── regressions/          ← "This broke before. Here's what happened."
├── preferences/          ← Your coding style — follows you across all repos
├── sessions/             ← Auto-captured AI session summaries
└── changelog/            ← Monthly git history syncs

事実は、物事の仕組みをエージェントに伝えます。決定事項は、同じ議論の繰り返しを防ぎます。リグレッションは、同じ不具合の再発を防ぎます。設定は、エージェントにあなたのコーディング方法を教えます。

クイックスタート

API キーを使う場合（Claude Code、ターミナルのワークフロー）

npx repomemory go

1 つのコマンドで、グローバルプロファイルの設定、.context/ の作成、Claude Code と Cursor の設定、AI 分析の実行、CLAUDE.md 用の手順の表示を行います。

Cursor を使う場合（API キー不要）

npx repomemory setup cursor

これにより、Cursor に必要なものがすべてインストールされます。

• ~/.cursor/mcp.json に MCP サーバー（すべてのプロジェクトで repomemory を自動起動します）
• .cursor/rules/repomemory.mdc に ルール（コンテキストの使い方を Cursor の AI に教えます）
• .cursor/commands/ に 6 つのコマンド（Cursor のチャットで / を使って実行します）

次に、Cursor のチャットで次を入力します。

/repomemory-analyze

Cursor 自身の AI がリポジトリをスキャンし、MCP ツールを介して .context/ に情報を登録します。外部 API キーは不要です。Cursor のサブスクリプションで利用できます。

利用可能な Cursor コマンド：

ガイド付きウィザード

npx repomemory wizard

プロバイダーの選択、ツールとの連携、最初の分析を順に進めます。API キーが検出されない場合は、外部分析を完全にスキップする 「なし — Cursor を使用」 オプションが表示されます。

非対話型（CI 対応）

npx repomemory go --yes --provider anthropic --embedding-provider gemini --max-files 80

--yes / --defaults / --no-prompt を使用すると、プロンプトは表示されません。

MCP サーバー — 実際のメモリを備えたエージェント

真価を発揮するのは MCP サーバーです。repomemory setup claude で設定すると、Claude Code とともに自動起動し、エージェントに 7 つのツールを提供します。

Agent: "Let me orient myself in this project..."
→ context_auto_orient()
→ Returns: project overview, preferences, recent sessions, recent changes

Agent: "Let me search for context about the auth flow..."
→ context_search("authentication flow")
→ Auto-routes to facts/ category, returns compact results

Agent: "I found a race condition. Let me record this."
→ context_write(category="regressions", filename="token-refresh-race", content="...")
→ Persisted. Detects if it supersedes an existing entry.

終了時にセッションが自動的に記録されます。設定は不要です。すべて repomemory setup claude が処理します。

対応ツール

Cursor ユーザーへ： API キーは不要です。npx repomemory setup cursor を実行し、Cursor のチャットで /repomemory-analyze を使用してください。Cursor の AI が MCP ツールを使って分析します。Cursor が使用しているモデルで分析されます（タスクの途中でモデルを切り替えることもできます）。

対応プロバイダー

埋め込み（任意、セマンティック検索用）：Gemini の text-embedding-004（無料、デフォルト）または OpenAI の text-embedding-3-small。利用可能な API キーから自動検出されます。

すべてのコマンド

repomemory go                            # One-command setup (add --yes for non-interactive)
repomemory wizard                        # Interactive guided setup
repomemory analyze                       # AI-powered repo analysis
repomemory analyze --merge               # Update without overwriting edits
repomemory analyze --dry-run             # Preview without API call
repomemory search <query>                # Search knowledge base from terminal
repomemory status                        # Coverage and freshness report
repomemory doctor                        # Diagnostics and health check
repomemory dashboard                     # Local web UI (localhost:3333)
repomemory risk                          # Hotspots, coupling, ownership analysis
repomemory risk -f src/auth.ts           # Targeted risk assessment for specific files
repomemory sync                          # Sync git history to changelog
repomemory setup <tool>                  # Configure Claude/Cursor/Copilot/etc
repomemory hook install                  # Auto-sync changelog on commits
repomemory global list                   # Manage global developer context
repomemory global export                 # Export global context as JSON

設定

リポジトリのルートにある .repomemory.json（すべてのフィールドは任意）：

{
  "provider": "anthropic",
  "model": "claude-sonnet-4-6",
  "embeddingProvider": "gemini",
  "hybridAlpha": 0.5,
  "maxFilesForAnalysis": 80,
  "enableGlobalContext": true
}

カスタムの ignorePatterns と keyFilePatterns は追加されます。組み込みのデフォルトを置き換えるのではなく、拡張します。

CLAUDE.md だけではだめですか？

repomemory は CLAUDE.md を置き換えるものではなく、補完するものです。CLAUDE.md は指示とルール用です。.context/ には、時間とともに蓄積される知識が保存されます。

貢献

開発環境のセットアップ、テスト、貢献ガイドラインについては、CONTRIBUTING.md を参照してください。

ライセンス

MIT