CodeGraph - コードの理解と分析を加速するオープンソースのコード知識グラフツール。 - AiBoss

CodeGraphとは何ですか？

CodeGraphは、AIコーディングエージェント向けの事前インデックス付きコード知識グラフツールで、MCPプロトコルを介してClaude Code、Cursor、Codex CLI、OpenCode、およびHermes Agentと深く統合されています。ツリーシッターを使用してコードベースを解析し、シンボル関係、呼び出しグラフ、およびコード構造をローカルのSQLiteデータベースに保存します。これにより、AIエージェントはグラフクエリを介してコードを直接検索できるようになり、従来のgrep/glob/readファイルスキャン方式に取って代わります。7つの実際のオープンソースプロジェクトを使用したベンチマークテストでは、CodeGraphがAPIコストを平均35%、トークン消費量を59%削減し、時間を49%節約し、ツール呼び出しを70%削減することが検証されています。しかも、外部APIキーを必要とせず、100%ローカルで動作します。

CodeGraphの主な機能

事前インデックス化されたコード知識グラフコードベースはtree-sitterによってASTに解析され、関数、クラス、メソッドなどのシンボルノード、および呼び出し、インポート、継承などの関係エッジが抽出され、リアルタイムでクエリ可能なSQLiteグラフデータベースが構築されます。
インテリジェントなコンテキスト構築単一のツール呼び出しでエントリポイント、関連シンボル、およびコードスニペットを取得できるため、高価な探索エージェントを使用してファイルごとにスキャンする必要がなくなります。
全文シンボル検索FTS5をベースとしており、コードリポジトリ全体にわたるリアルタイムのシンボル名検索を可能にし、対象コードを迅速に特定します。
影響範囲分析あらゆるシンボルの発信者、着信者、および影響力の全範囲を追跡し、変更前にその影響を評価する。
フレームワーク対応ルーティング14種類のWebフレームワークのルーティングファイルを自動的に識別し、URLパターンを対応するハンドラ関数/クラスに関連付けます。
リアルタイム自動同期: ネイティブOSファイルイベント（FSEvents/inotify/ReadDirectoryChangesW）を通じてプロジェクトの変更を監視し、2秒間のデバウンス後にマップを自動的に増分同期します。
変更影響テストの追跡：codegraph affected このコマンドは、変更されたファイルの推移的依存関係を追跡し、影響を受けるテストファイルを正確に特定することができ、CIパイプラインに適しています。
設定不要、すぐに使用可能ファイル拡張子に基づいて言語を自動的に認識し、それに応じて自動的に対応します。 .gitignore ルールのみで、設定ファイルを作成する必要はありません。

CodeGraphの使い方

CodeGraphをインストールする: ターミナルで実行 curl -fsSL https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.sh | sh（macOS/Linux）または irm https://raw.githubusercontent.com/colbymchenry/codegraph/main/install.ps1 | iex(Windows PowerShell)；Node.jsがインストールされているユーザーは、直接実行することもできます。 npx @colbymchenry/codegraph
統合エージェントを選択インストーラーは、システムに既にインストールされているAIエージェント（Claude Code、Cursor、Codex CLI、opencode、Hermes Agent）を自動的に検出し、設定するエージェントを選択するように対話的に促し、設定を自動的にMCPに書き込みます。
AIエージェントを再起動しますインストール後、対応するAIエージェントを再起動して、MCPサーバーの設定を有効にしてください。
プロジェクトインデックスを初期化しますプロジェクトディレクトリに移動して実行してください。 codegraph init -iこれにより、プロジェクトのナレッジグラフインデックスが構築され、プロジェクトレベルのプロキシルールファイル（例：...）も自動的に構成されます。 .cursor/rules/codegraph.mdc）
使用を開始するプロジェクトディレクトリに以下が含まれている場合 .codegraph/ フォルダにアクセスすると、AIエージェントはコードのクエリと探索のためにCodeGraphツールを自動的に起動します。このツールはCLI経由でも実行できます。 codegraph query <关键词>、codegraph callers <符号名> コマンドによる手動クエリ

CodeGraphの主な利点

使用コストを大幅に削減7つの実際のオープンソースプロジェクト（VS Code、Excalidraw、Django、Tokio、OkHttp、Gin、Alamofire）でテストした結果、APIコストを平均35%、トークン消費量を59%、実行時間を49%、ツール呼び出しを70%削減できることが分かりました。特に大規模なリポジトリでは、その効果が顕著です。
100%ローカルのプライバシーとセキュリティすべてのデータはローカルのSQLiteデータベースに保存されるため、インターネット接続、APIキー、データアップロードは不要であり、コードのプライバシーを完全に保護します。
クロスプラットフォーム対応の自己完結型オペレーションWindows (x64/arm64)、macOS (x64/arm64)、および Linux (x64/arm64) 用のスタンドアロンビルドパッケージを提供し、Node ランタイムが組み込まれているため、ローカルコンパイルや追加の Node.js インストールは不要です。
19以上の言語に対応TypeScript、JavaScript、Python、Go、Rust、Java、C#、PHP、Ruby、C/C++、Swift、Kotlin、Scala、Dart、Svelte、Vue、Liquid、Pascal/Delphi、Lua、Luauといった主流言語およびニッチな言語を完全にサポートしています。
フレームワークの深い統合Django、Flask、FastAPI、Express、NestJS、Laravel、Rails、Spring、Gin、React Router、SvelteKitなど14のフレームワークのルーティング構文をネイティブに認識し、URLとプロセッサを正確に関連付けます。
エージェントのシームレスな統合MCPプロトコルを介して主流のAIコーディングプロキシと連携し、インストーラーがJSON設定ファイルを手動で編集することなく、自動的に設定を完了します。

CodeGraphのプロジェクトアドレス

GitHubリポジトリ：https://github.com/colbymchenry/codegraph

CodeGraphの応用シナリオ

建築に関する質問への迅速な回答AIエージェントに「拡張ホストプロセスはメインプロセスとどのように通信するのか？」といったアーキテクチャに関する質問を投げかけてみてください。エージェントは、分岐したファイルスキャンを行うことなく、グラフを通して関連するソースコードを直接特定できます。
コードレビューと影響分析コア機能を変更する前に、 codegraph_impact 回帰問題の発生を避けるため、変更範囲を分析してください。
入門とコードへの慣れ新しいチームメンバーは、自然言語を使ってAIエージェントに質問することで、プロジェクト構造、モジュール間の依存関係、主要なビジネスロジックを迅速に理解できます。
精密な検査と位置決めCIをパイプラインに統合する git diff そして codegraph affectedコード変更の影響を受けるテストファイルのみを実行するため、ビルド時間が短縮されます。
クロスファイル再構築アシスタント公開APIをリファクタリングする際は、呼び出し元/呼び出し先を使用してすべてのライブラリ参照を追跡し、すべての呼び出しが同期的に更新されるようにしてください。

すべてのカテゴリ