Graphifyはコードを検索対象から関係グラフへ変える

tree-sitterでコードを局所解析する設計

README は Graphify を、コード、ドキュメント、SQL スキーマ、設定、PDF などから問い合わせ可能な知識グラフを作るツールとして説明します。コードは tree-sitter AST でローカルかつ決定的に解析され、LLM を使わず、コードがマシンの外へ出ない設計です。

一方、文書、PDF、画像、動画や音声の意味的な処理には、利用するアシスタントのモデルまたは設定した API キーが使われると記されています。したがって「ローカル」は全入力に同じ意味で適用されません。対象ディレクトリに機密資料を置く場合は、コード解析と意味解析を分けて実行条件を確認する必要があります。

Graphify の確認では、graphify-out/graph.html、GRAPH_REPORT.md、graph.json を同じ実行結果として保存します。対象コミットと入力パスを添え、EXTRACTED と INFERRED の辺を元ソースへ戻れる形で比較します。 tree-sitterでコードを局所解析する設計 の条件を、他の章の観測と混ぜずに記録します。

EXTRACTEDとINFERREDを分ける辺の表示

グラフの各接続には EXTRACTED または INFERRED のタグが付きます。前者はソースに明示された関係、後者は Graphify が解決した関係です。README の APIRouter の例では、routing.py の行番号、コミュニティ、次数、uses や imports といった接続が表示されます。

この区別は、生成されたグラフをそのまま事実一覧と扱わないための手掛かりになります。`graphify explain "APIRouter"` の結果で EXTRACTED の参照元を先にたどり、INFERRED の辺は元ファイルの定義や import と照合する、という読み方ができます。README はタグの存在を説明しますが、誤解決率や完全性の測定値は示していません。

Graphify の確認では、graphify-out/graph.html、GRAPH_REPORT.md、graph.json を同じ実行結果として保存します。対象コミットと入力パスを添え、EXTRACTED と INFERRED の辺を元ソースへ戻れる形で比較します。 EXTRACTEDとINFERREDを分ける辺の表示 の条件を、他の章の観測と混ぜずに記録します。

graph.html、GRAPH_REPORT.md、graph.jsonの役割

`/graphify .` を実行すると graphify-out/ に graph.html、GRAPH_REPORT.md、graph.json の三つのファイルが生成されます。graph.html はブラウザでノードをクリック、絞り込み、検索する画面、GRAPH_REPORT.md は主要概念や接続、質問候補、graph.json は全グラフを保持するファイルとして説明されています。

出力が三つに分かれるため、探索と自動処理を分離できます。人が graph.html でコミュニティを確認し、レビュー資料にはレポートを使い、繰り返しの問い合わせには JSON を使う流れです。初回は生成日時、対象コミット、ファイル数を控え、graph.json のノードと辺が入力のどのパスに対応するかを少数件で照合します。

Graphify の確認では、graphify-out/graph.html、GRAPH_REPORT.md、graph.json を同じ実行結果として保存します。対象コミットと入力パスを添え、EXTRACTED と INFERRED の辺を元ソースへ戻れる形で比較します。 graph.html、GRAPH_REPORT.md、graph.jsonの役割 の条件を、他の章の観測と混ぜずに記録します。

queryとpathで関係をたどる

README には `graphify query "<question>"` が自然言語の質問に対するスコープ付きサブグラフを返し、`graphify path A B` が二つの対象の接続経路をたどるとあります。FastAPI から ModelField への例では、uses と references を経由する3ホップの経路が表示されます。

`graphify explain` は一つの概念の出典と接続を調べる操作で、query や path と役割が異なります。導入評価では同じ質問を再実行し、返るノード集合、出典行、EXTRACTED と INFERRED の内訳を保存します。自然言語による意味解析を含める場合は、アシスタントと API キーの設定が結果へ影響しうる点を分けて記録します。

Graphify の確認では、graphify-out/graph.html、GRAPH_REPORT.md、graph.json を同じ実行結果として保存します。対象コミットと入力パスを添え、EXTRACTED と INFERRED の辺を元ソースへ戻れる形で比較します。 queryとpathで関係をたどる の条件を、他の章の観測と混ぜずに記録します。

対応プラットフォームと導入コマンド

開始手順は `uv tool install graphifyy` または `pipx install graphifyy`、続いて `graphify install`、アシスタント側で `/graphify .` です。README は Claude Code、Cursor、Codex、Gemini CLI、GitHub Copilot など複数の環境で動くとし、15以上のプラットフォームから選ぶ導線を置いています。

この記述は連携先の一覧であり、各環境の権限モデルやバージョン互換表ではありません。まず使用するアシスタント一つに絞り、`graphify install` 後にスキルが認識されること、対象外のファイルが読まれないこと、出力先が期待した graphify-out/ になることを確認します。README の早期アクセス版 graphify.com は、ローカル CLI と別の提供形態として扱います。

Graphify の確認では、graphify-out/graph.html、GRAPH_REPORT.md、graph.json を同じ実行結果として保存します。対象コミットと入力パスを添え、EXTRACTED と INFERRED の辺を元ソースへ戻れる形で比較します。 対応プラットフォームと導入コマンド の条件を、他の章の観測と混ぜずに記録します。

MITとv0.9系を踏まえた判断

素材のメタデータではライセンスは MIT、デフォルトブランチは v8、最新リリースは v0.9.51 です。README は graphify.com の公開前早期アクセスにも触れていますが、サービスの料金、SLA、保存方針を CLI の説明としては定義していません。

Graphify の価値は、grep でファイルを横断する作業を、関係、経路、根拠の単位へ組み替える点にあります。ただしグラフの推論結果を設計判断へ使うなら、元ソースへのリンクを必ず残す運用が必要です。採用可否は、SQLやPDFを含む自分のリポジトリで出典が追えるかを確認して決めるのが妥当です。

Graphify の確認では、graphify-out/graph.html、GRAPH_REPORT.md、graph.json を同じ実行結果として保存します。対象コミットと入力パスを添え、EXTRACTED と INFERRED の辺を元ソースへ戻れる形で比較します。 MITとv0.9系を踏まえた判断 の条件を、他の章の観測と混ぜずに記録します。

編集部の結論

Graphify は複数言語のコードと関連文書を、ローカル中心の可視化と問い合わせへ変えたい開発者に向きます。採用前には `uv tool install graphifyy` から `/graphify .` までを小さなリポジトリで実行し、graph.json の辺の根拠、PDFや画像を含めた時のモデル利用、出力ファイルの差分を確認してください。README の自己申告だけでは解析精度を保証できません。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes