CompareGraph

CompareGraph

すでにインストール済みですか？ comparegraph doctor を実行してください。

Claude Code、Codex、Cursor、Gemini CLI、Windsurf、OpenCode、その他6つのエージェントで複数のリポジトリを比較

複数のクローンをまとめた1つのグラフ · すべてのセルに根拠付きの判定 · 29言語 · 100%ローカル、モデル呼び出しなし
Rust製の単一バイナリ

使い方 · コマンド · MCP ツール · よくある質問 · トラブルシューティング · ロードマップ · レポート

CompareGraph は、クローンした複数のリポジトリを 1 つの SQLite グラフに解析します。各クローンを分類体系（機能の「ファミリー」）に照らしてスコアリングし、クローンと機能ごとに、ファイルと行範囲への引用を添えた判定を記録します。CLI と MCP サーバーを備えた単一の Rust バイナリです。クローンを読み取りますが、実行はしません。モデルを呼び出すこともありません。

はじめに

ランタイムのインストールは不要です。必要なのは 1 つのバイナリだけです。Node ユーザーは、npx -y @massrelay-ai/comparegraph から同じバイナリを実行できます。

1. バイナリをインストールする

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/massrelay-ai/comparegraph/main/scripts/install.sh | sh

# Windows x64 (PowerShell)
irm https://raw.githubusercontent.com/massrelay-ai/comparegraph/main/scripts/install.ps1 | iex

_{リリースの SHA256SUMS（linux-x64、linux-arm64、darwin-arm64、darwin-x64、win32-x64。v0.1.2 以降は gh attestation verify <asset> -R massrelay-ai/comparegraph による証明も確認）と照合したうえで、~/.local/bin に書き込みます（Windows の場合は %LOCALAPPDATA%\Programs\comparegraph に書き込み、ユーザーの PATH に追加します。その後、新しいターミナルを開いてください）。COMPAREGRAPH_VERSION=v0.1.1 でリリースを固定できます。COMPAREGRAPH_INSTALL_DIR でバイナリの配置先を変更できます。}

2. エージェントを設定する

comparegraph setup --apply      # omit --apply for the plan; --scope project for an entry you commit
comparegraph doctor             # each client's state: aligned, stale, conflict, missing, plugin

_{マシン上で見つかったすべてのエージェント（12 個：Claude Code、Codex、Cursor、Gemini CLI、OpenCode、Hermes、Windsurf、Antigravity、Kiro、Copilot、Copilot CLI、Qwen Code）に MCP サーバーを登録し、ワークスペースの指示ファイルに短いルールブロックを書き込みます。また、Claude Code にはセッション開始フックを設定します。エージェントの設定のみを行い、インデックス作成は行いません。}

/plugin install comparegraph --marketplace massrelay-ai/comparegraph

3. クローンを追加してビルドする

comparegraph add ../some-clone --name some
comparegraph build some

_{クローンは読み取られますが、実行されることはありません。ワークスペースごとに 1 つのストアが .comparegraph/ の下に作成されます。再ビルドは増分的に行われ、build --full と同じハッシュになります。}

4. 比較

comparegraph family add families/example-code-graph-tools   # the taxonomy
comparegraph map some example-code-graph-tools              # ranked candidates per feature, writes nothing
comparegraph claim some symbols.extraction has --author me --at <path>:<start>-<end>
comparegraph matrix example-code-graph-tools                # features x clones, prevalence, gaps

_{ファミリーパックはバイナリには含まれず、このリポジトリに収録されています。そのため、このリポジトリをクローンして実行してください。以下のサンプルでは、収録されているサンプルを使い、実際の出力とともにこれらすべての手順を紹介しています。}

収録サンプルですぐに始める

サンプルパックとサンプルリポジトリは、バイナリではなくリポジトリに収録されています。使用方法では、fixtures/typescript を10個の機能を含むサンプルパックと照合し、add から export vault まで、すべての手順の実際の出力を紹介しています。

アンインストールについては、エージェント、プラットフォーム、アンインストールを参照してください。

CompareGraph を選ぶ理由

6つの調査用コピーと30個の機能で測定したバイナリ0.1.1の数値はdocs/assets/cost.json、手法と注意事項は回答サイズレポートに記載されています。

リポジトリが多数あり、知りたいことは1つです。各リポジトリに何があるのでしょうか。すべてを手作業で読むのは現実的ではありません。行番号のない要約は検証できず、コードが移動するとメモも古くなります。以下は、それぞれ検証可能な5つの特性です。

1. 決定論的です。 同じクローンとバージョンであれば、同じ store_hash が得られます。comparegraph check は再構築して比較し、インクリメンタルビルドの結果は build --full と一致する必要があります（Plan 6 レポートにある大規模な2つのツリーで一致）。
2. すべての回答に証拠クラスがあります。 各エンベロープには observed、derived、inferred、unknown のいずれかと、エンジンが確認できない内容を示す limitations[] リストが含まれます。
3. 主張には、現在解決可能な引用が必要です。 has と partial には、保存済みノードと一致する --at path:start-end が必要です。一致しない場合、エンジンは拒否します。コード移動後に引用が無効になると、check の後で unknown* と表示されます。
4. none には不在の証明が必要です。 何も見つからない検索語を指定する --searched、または同じ検索語を指定し、見つかった各項目を開いて却下したものとして --read-hits に列挙する方法、あるいはグラフチェックが必要です。グラフチェックでは4つの経路（シンボル、パス、コミュニティ用語、ノード種別）のすべてが空であることを確認します。--searched を指定した none では、absent-check --searched が返す上位10件の候補を、読み取り済みとして列挙する必要があります（read_set）。上限を超えた候補は read_capped の制限として記録されます。上位10件に未読の候補がある場合、主張は拒否され、その候補が示されます。
5. エンジンにモデルはありません。 スコア、評価区分、説明、候補は、保存済みの事実から計算されます。読み取りはエージェントが行えますが、エンジンは保存、検証、拒否のみを行います。

対象：自社製品を業界内で比較するチーム、複数プロジェクトのデューデリジェンス、業界の全体像を把握する新規参入者（family propose で分類体系のドラフトを作成できます）、MCP を通じて簡潔な事実を必要とするコーディングエージェントです。

動作の仕組み

1. エンジンはモデルを呼び出しません。 すべてのスコア、バンド、説明、候補は保存済みの事実から計算されます。
2. 主張には、現時点で解決できる引用が必要です。 has と partial には、保存済みノードと一致する --at path:start-end が必要です。 none には、何も見つからない検索語を指定する --searched、またはグラフチェックが必要です。それ以外の場合、エンジンは拒否するか、unknown を記録します。
3. 主張と決定は追記専用であり、データベースによって強制されます。 変更は、置き換える対象の行を指定した新しい行として記録します。 最新の行が優先され、履歴はそのまま残ります。

search または map による候補には candidate とラベルが付けられ、has にはなりません。設計： docs/design.md。

フローとコードリングの図については、docs/design.md を参照してください。

グラフ内のファミリー

ファミリーは分類体系です。機能のグループで構成され、それぞれに定義と、その機能を備えていると見なす条件のテストがあります。セルは、1 つのクローンと 1 つの機能の組み合わせで、判定（has、partial、none）と、has および partial の場合は引用を保持します。この図は、マッピングのゴールドにおいて合意されたセルを使って、ファミリー code-graph-tools を描画したものです。Obsidian では comparegraph export vault を実行すると、同じグラフをライブで表示できます。

プラグインと第 2 のエンジン

外部プロバイダーとは、stdin と stdout で JSON 行をやり取りする実行可能ファイルです。ホストはリクエスト行を 1 行書き込んで stdin を閉じ、最初の ok 応答が届くまで応答行を読み取ります。プロバイダーが出力する内容はすべてデータとして扱われ、独自の型に解析されます。comparegraph.toml に登録するか（[providers.mine] command = "tools/my-provider"）、comparegraph-provider-<name> として PATH に配置し、その横に comparegraph-plugin.toml マニフェスト（kind、name、protocol = "1"、languages、network）を置きます。マニフェストがない場合は、--allow-unverified を指定した場合にのみ実行されます。

完全なプロトコル、ガード、25 行の Python プロバイダー、code-review-graph アダプター（build --providers reference,crg の背後にある第 2 のエンジン）については、docs/dev/plugin-protocol.md を参照してください。

ファミリーと 7 つのスキル

ファミリーは rows.md を含むディレクトリです。2 つのパックが同梱されています。クイックスタート用の 10 個の機能を含む families/example-code-graph-tools と、マッピングのゴールドとなる 30 個の機能を含む families/code-graph-tools です。列のルール、同義語、family propose については、使い方を参照してください。

この手法は、どのエージェントでも読める skills/ 内の 7 つのプレーンな Markdown スキルで構成されています。それぞれに、動詞を使う場面、正確なコマンド、エンジンが拒否する内容、確認方法が記載されています。Claude Code では、スキルと MCP サーバーが 1 つのプラグインとして一緒に提供されます（はじめに）。他のエージェントは、クローン内の skills/ ディレクトリを読み込みます。

使用方法

docs/ 以下の4ページにリファレンスがあります。いずれもここから数クリックで開けます。

得られるもの

4つのレベルがあり、それぞれが「どのように把握しているか」に答えます。リポジトリの概要、モジュールのコミュニティ、シンボル（呼び出し元、呼び出し先、影響範囲、テスト、エントリーポイント、デッドコードの候補）、そして主張（判定、引用、作成者、経緯）です。各回答は、エビデンスクラスを含む1つのJSONエンベロープです。使用方法に表と実際のshowの回答があります。

CLI リファレンス

グローバルオプションの--rootと--prettyに続いて、動詞は4つのグループに分かれています。ビルドと調査、グラフクエリ、ファミリーと主張、エクスポートとエージェントです。コマンドには、重要なフラグとともにすべての動詞が記載されています。

MCP ツール

comparegraph mcpは、標準入出力経由で18個のツールを提供します（読み取り専用が17個、書き込みが1個：comparegraph_claim）。意図的にdecideツールはありません。MCP ツールに表があり、docs/catalog.jsonが機械可読な情報源です。catalog --checkがCIで内容を検証します。

Vault、設定、ライブラリ

comparegraph export vault --out ./vaultは、生成された説明を含むObsidian形式のMarkdown Vaultを書き出します。設定には--rootとCOMPAREGRAPH_*環境変数を使い、クレートは各動詞を関数として公開します。この3項目はすべて使用方法に記載されています。

精度はどのくらいか

以下の数値はすべて、このリポジトリ内のレポートから引用しています。引用する前に、各レポートの注意事項を確認してください。いずれも2026-10-13に1台の共有ホストで測定されました。

手作業でラベル付けした呼び出し箇所のゴールドデータでは、CompareGraphの全件合算の適合率は0.995、再現率は0.834です。アダプター経由のcode-review-graphは0.956 / 0.736、codegraphは0.708 / 0.506です。38,258ファイルのリポジトリを499.6秒でビルドし、1.29Mエッジのグラフでimpactに2.5秒で回答します。以下の表に注意事項を記載しています。データ： accuracy.json、scale.json；パリティレポート：エンジンのパリティ。

29 言語を解析します。そのうち5言語は詳細に解決され、4言語には測定済みのゴールドスタンダードがあります。見出しだけでなく、各ティアを確認してください。 すべての文法（tsx、jsx、mjsを別々に数えて32 ID）には、コミット済みのグラフダイジェストを含むフィクスチャが fixtures/languages/にあります。そのため、文法の更新でグラフが少しでも変わるとCIが失敗し、意図的にゴールドデータを更新する必要があります。

エージェント、プラットフォーム、アンインストール

comparegraph setup はエントリーを書き込みます。comparegraph doctor は各クライアントの状態（aligned、stale、conflict、 missing、unverified、plugin）を報告します。--client all は、インストール済みと見られるクライアントのみを対象にします。plugin：comparegraph@comparegraph が有効で --client all が使用されている場合は、Claude Code プラグインに任せます。エントリーを強制的に書き込むには、--client claude を指定します。PATH 上で登録済みのバイナリに解決される単独の comparegraph コマンドは、整合しているものとして扱われます。setup --apply は既存の設定に追加し、<file>.bak-<unix-seconds> という名前のバックアップを残します。異なるエントリーは、--force を指定しない限りそのまま残されます。

setup は、エージェントの指示ファイルにルールブロックも書き込み、Claude Code の場合は SessionStart フックも書き込みます。詳しくは使い方をご覧ください。

プラットフォーム：各リリースでは、linux-x64、linux-arm64、darwin-arm64、darwin-x64、win32-x64 向けのビルドをそれぞれ専用のランナーで行い、SHA256SUMS に記載されたリリースアセットとして配布します。Homebrew tap はリリースに追随します。テストスイートは linux-x64 のみで実行されます。Rust 1.85+ が動作する環境であれば、ソースからビルドできます。ローカル環境のみで動作します。エンジンはネットワークへの接続を行わず、MCP サーバーは stdio 経由で通信し、ストアはユーザーが所有する 1 つの SQLite ファイルです。

アンインストール：上記のエントリーを削除し（プラグインを使用している Claude Code では /plugin uninstall comparegraph）、次にバイナリ（~/.local/bin/comparegraph、brew uninstall comparegraph、または cargo uninstall comparegraph）を削除して、各ワークスペースで rm -r .comparegraph を実行します。

FAQ とトラブルシューティング

• FAQ：code-review-graph や codegraph との違い（および、それらにあって comparegraph にない機能）、モデルを使用するかどうか（使用しません）、コードを代わりに採用するかどうか（しません）、一部の呼び出しエッジが 0.5 になる理由、対応していないことについて説明します。
• トラブルシューティング：no workspace や拒否された none の申告から、無反応のセッション開始フックまで、12 の症状とその原因を説明します。
• まず comparegraph doctor を実行してください。ストア、すべてのプロバイダー、各クライアントの登録状態が報告されます。

ロードマップ

以下はまだ何も実装されておらず、順序はメンテナーが決定します。各項目の測定結果を含む全リストはこちらです：docs/roadmap.md。

• 次に測定する有効策：ストア内のテキストチャネル（ドキュメントコメントとシグネチャのトークン）およびファミリーごとの同義語を追加し、見たことのないクローンに対する map の精度を高めます。
• 採用済み機能向けの Port-kit エクスポート、機能統計のエクスポート、クレームのインポート、family import/export。
• グラフ同等性クエリ、C/C++/C# リゾルバー、ファイルごとの分析キャッシュ、対応クライアントの追加（Zed、Continue）。

ドキュメント

貢献、ライセンス、サードパーティコード

セキュリティに関する報告は [email protected] または非公開のアドバイザリー（SECURITY.md）へ、行動規範に関する報告は同じアドレス（CODE_OF_CONDUCT.md）へお送りください。

まず CONTRIBUTING.md と AGENTS.md をお読みください。バグ修正では、まず失敗するテストを追加します。抽出処理の変更では、適合性フィクスチャを拡張します。また、エンジンにモデル呼び出しやネットワーク呼び出しを持ち込んではなりません。CI では clippy、テストスイート、適合性チェックと言語ダイジェストの検証、および cargo-deny（ライセンス、アドバイザリー、ソース；deny.toml）を実行します。ベンダー化されたパーサーレイヤーは graphmind から取得しています（MIT）。docs/THIRD_PARTY_NOTICES.md をご覧ください。ライセンスは Apache-2.0 です。詳しくは LICENSE をご覧ください。