Repolode
Jakedismo

Jakedismo/codegraph-rust

コードベースのセマンティックなナレッジグラフを構築し、MCP経由でコーディングエージェントにエージェント型のコード解析ツールを提供するRust製ツール。

スター
913
フォーク
98
未解決の Issue
17
最終コミット
26 日前

これは何?

CodeGraphは、AST解析、任意のLanguage Serverによるシンボル解決、モジュールのリンク、埋め込みを組み合わせ、プロジェクトをノードとエッジからなるナレッジグラフにインデックス化します。グラフは各プロジェクトの`.codegraph`ディレクトリにある組み込みSurrealDBデータベースに保存されるため、別途データベースサーバーを用意する必要はありません。

Claude Code、Cursor、CodexなどのAIコーディングアシスタント向けに設計されています。4つの統合されたエージェント型ツール(context、impact、architecture、quality)がグラフ上で推論エージェントを実行し、検索結果の生リストではなく、ファイルパス、行番号、範囲を制限したコード断片を添えた回答を返します。インデックス作成はfast、balanced、fullの段階に分かれており、グラフの詳細度と速度・ストレージ使用量のバランスを選べます。

検索では、ベクトル類似度と語彙マッチングを組み合わせ、任意で再ランキングも行います。また、実行ごとにモデルへ渡すツール出力の量を制限し、Ollama、LM Studio、Jina、OpenAI、Anthropicなど複数の埋め込み・LLMプロバイダーに対応しています。

主な機能

  • 01コードのノード、エッジ、モジュール、データフローの関係からナレッジグラフを構築します。
  • 02context、変更の影響、アーキテクチャ、品質分析を行う4つのエージェント型MCPツールを提供します。
  • 03任意のLSP解決に対応し、fast、balanced、fullのインデックス作成段階を選べます。
  • 04プロジェクトごとに組み込みSurrealDBへデータを保存するため、別途サーバーは不要です。
  • 05ベクトル検索と語彙検索を組み合わせ、任意で再ランキングを行います。
  • 06.gitignoreを尊重し、インデックス作成時に一般的な秘密情報ファイルのパターンを除外します。

ユースケース

  • 大規模なコードベースをリファクタリングする前に、Claude CodeやCursorへプロジェクト全体のコンテキストを提供する。
  • 関数、型、モジュールを変更した場合に、どこへ影響が及ぶかを見積もる。
  • なじみのないRustプロジェクトのアーキテクチャ概要を把握したり、複雑性の高い箇所を見つけたりする。
  • ローカルまたはセルフホストの埋め込みモデルを実行し、ソースコードを手元のマシンから外に出さない。

クイックスタート

  1. 1

    Installation Guide(docs/INSTALLATION_GUIDE.md)に従ってCodeGraphをインストールする

  2. 2

    balanced tierでプロジェクトをインデックス化する

    codegraph index /path/to/project --index-tier balanced
  3. 3

    コマンドラインから質問する

    codegraph agent context "your question"

使う前に知っておきたいこと

  • balanced tierとfull tierでインデックス化するには、rust-analyzer、node、goplsなどの外部言語サーバーをインストールする必要があります。
  • インデックス化には多くの設定オプションと環境変数があるため、セットアップにはある程度の手間がかかります。

収録されている特集

トピック

よくある質問

codegraph-rust とは?
コードベースのセマンティックなナレッジグラフを構築し、MCP経由でコーディングエージェントにエージェント型のコード解析ツールを提供するRust製ツール。 CodeGraphは、AST解析、任意のLanguage Serverによるシンボル解決、モジュールのリンク、埋め込みを組み合わせ、プロジェクトをノードとエッジからなるナレッジグラフにインデックス化します。グラフは各プロジェクトの`.codegraph`ディレクトリにある組み込みSurrealDBデータベースに保存されるため、別途データベースサーバーを用意する必要はありません。
codegraph-rust は無料で使えますか?ライセンスは?
codegraph-rust にはライセンスが明記されていません。コードは公開されていますが、ライセンスがない場合は再利用の許諾がないため、利用前に作者に確認することをおすすめします。
codegraph-rust は今もメンテナンスされていますか?
活発にメンテナンス中。codegraph-rust の最終コミットは 2026年10月12日 です。
codegraph-rust は何に使えますか?
大規模なコードベースをリファクタリングする前に、Claude CodeやCursorへプロジェクト全体のコンテキストを提供する。 関数、型、モジュールを変更した場合に、どこへ影響が及ぶかを見積もる。 なじみのないRustプロジェクトのアーキテクチャ概要を把握したり、複雑性の高い箇所を見つけたりする。 ローカルまたはセルフホストの埋め込みモデルを実行し、ソースコードを手元のマシンから外に出さない。
codegraph-rust のインストール方法は?
Installation Guide(docs/INSTALLATION_GUIDE.md)に従ってCodeGraphをインストールする balanced tierでプロジェクトをインデックス化する: codegraph index /path/to/project --index-tier balanced コマンドラインから質問する: codegraph agent context "your question"
codegraph-rust はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/Jakedismo/codegraph-rust

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト