Graphify-Labs/graphify

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.

解決する課題

Graphifyは、コードベースとその関連ドキュメント（PDF、画像、動画）をクエリ可能なナレッジグラフに変換します。これにより、開発者はgrepでファイルを手動検索したり、生のソースコードを読み込んだりする代わりに、概念間の関係をクエリしたりパスを辿ったりすることで、複雑なプロジェクトを理解できるようになります。

仕組み

Graphifyは、決定論的なパースと意味解析を組み合わせて使用します：

  • コードパース: tree-sitter ASTを使用して、約40の言語のコードをローカルでパースします。このプロセスは決定論的であり、LLMを必要としないため、コードがマシン内に留まることが保証されます。
  • セマンティックパス: PDF、画像、動画などの非コードファイルに対しては、設定されたAIモデルまたはAPIキーを使用してセマンティックパスを実行します。
  • グラフ構築: ノードが概念、エッジが接続（例：calls, imports, inherits）となるグラフを作成します。エッジには EXTRACTED（ソース内で明示的に発見）または INFERRED（ツールによって導出）というタグが付けられます。
  • 統合: さまざまなAIコーディングアシスタント（Claude Code、Cursor、GitHub Copilotなど）の「スキル」として統合され、アシスタントがファイルを一つずつ読む代わりにグラフをクエリできるようにします。

対象者

大規模で複雑なコードベースをナビゲートして理解する必要がある開発者やエンジニア、および、AIコーディングアシスタントにプロジェクトの構造化されたハイレベルなアーキテクチャ理解を提供したいと考えているアシスタント利用者。

ハイライト

  • ローカルファーストのコードマッピング: LLMを必要とせず、tree-sitter ASTを介してローカルでコードをパースします。
  • マルチモーダル対応: コード、ドキュメント、PDF、画像、動画/音声を単一の統合されたグラフにマッピングします。
  • クエリ可能なインターフェース: 概念の説明、2つのノード間の最短経路の検索、または自然言語によるクエリを実行するためのコマンドを提供します。
  • 可視化: コードベースを力学モデルグラフとして閲覧するためのインタラクティブな graph.html を生成します。
  • 幅広いアシスタント互換性: カスタムスキルのインストールを通じて、20以上のAIコーディングアシスタントをサポートします。
  • 信頼度タグ付け: 明示的に抽出された関係と、推論された関係を区別します。