Graphify:Claude Code のためのコードベース知識グラフ
Graphify はリポジトリ——コード、ドキュメント、SQL スキーマ、設定、PDF——を、Claude Code の中から問い合わせできる知識グラフに変えます。tree-sitter によるローカル解析、すべての辺にタグ、ベクトルストアは使いません。
Graphify の要点
- サードパーティのオープンソースプロジェクト(Graphify-Labs/graphify、Apache-2.0、Python 製)で、Anthropic の製品ではありません。Claude Code、Cursor、Codex、Gemini CLI などで使える `/graphify` スキルを提供します。
- コードは tree-sitter で AST に解析されます。ローカルかつ決定的で、モデル呼び出しはありません。すべての辺には `EXTRACTED`(ソースに明示)または `INFERRED`(Graphify が解決)のタグが付きます。
- たどるためのグラフであり、ベクトルインデックスではありません。埋め込みもベクトルストアもなし。`/graphify query` は回答に必要なノードと辺だけを返します。
- 3 つのコマンドで動きます:`uv tool install graphifyy`、`graphify install`、リポジトリ内で `/graphify .`。出力は `graphify-out/` に置かれます。
Graphify-Labs/graphify — repository and README
出典github.com2026-11-15
Graphify Quickstart
出典docs.graphify.com2026-11-15
GitHub REST API — repos/Graphify-Labs/graphify
出典api.github.com2026-11-15
このページのコマンド、フラグ、ファイル名は 2026-11-15 に上の 3 つの出典から読み取ったものです。コマンドとパスは意図的に翻訳していません——翻訳されたコマンドは実行できないからです。
2026-11-15 に確認。リポジトリのデフォルトブランチは v8、最終 push は 2026-11-14 です。star と fork は毎日動くので、引用する前に API を読み直してください。
Graphify とは何か
プロジェクト自身の説明:あらゆるコードベースを、そのドキュメント、SQL スキーマ、設定、PDF ごと、問い合わせ可能な知識グラフに変える——Claude Code、Cursor、Codex、Gemini CLI のための `/graphify` スキル。ローカルで決定的な AST 解析、すべての辺に説明があり、ベクトルストアは使いません。
実際の流れはこうです。CLI(`graphify`)とスキルを入れ、アシスタントの中で `/graphify` と入力します。アシスタントが detection、extraction、clustering を実行し、グラフを `graphify-out/` に書き出し、以後の質問にはツリーを grep する代わりにそのグラフをたどって答えます。
- ライセンス
- Apache-2.0
- 言語
- Python(パッケージ名 graphifyy)
- star / fork
- 147,983 / 14,194 — 2026-11-15 時点のスナップショット
- 状態
- サードパーティ。デフォルトブランチ v8、最終 push 2026-11-14
Anthropic のプロジェクトではありません
Graphify は Graphify-Labs 組織が Apache-2.0 で公開しています(GitHub API の is_verified は false)。Anthropic は保守しておらず、Claude Code に同梱もされていません。自分でインストールし、自分のファイルに対して動かします。
グラフはどう作られるか
コードは tree-sitter で AST に解析されます。この処理は決定的で、あなたのマシン上で完結します。LLM もなし、外部送信もなし。ファイル間の関係(calls、imports、inherits、mixes_in)は AST から取り出され、約 40 言語に対応します。`# NOTE:` / `# WHY:` コメントや ADR・RFC への参照もノードになります。
ドキュメント、PDF、画像、動画は 2 パス目の意味解析に回り、アシスタントのモデルか設定した API キーを使います。トークンを消費するのはこの部分で、コードマップ自体は消費しません。
すべての辺に説明がある
つながりにはタグが付きます。ソースに明示されていれば `EXTRACTED`、Graphify が解決したものは `INFERRED`。コードから読んだのか、推論したのかが分かります。
ベクトルインデックスではありません
埋め込みもベクトルストアもありません。出力は本物のグラフ——ノード、辺、コミュニティ、god node——で、`query`、`path`、`explain` でたどります。
Claude Code に Graphify を入れる
コマンド 3 つ。`graphify install` のデフォルト対象は Claude Code で、他のアシスタントはフラグ 1 つで切り替わります。
CLI をインストールする
パッケージ名は `graphifyy`——y が 2 つです。`graphify` と `graphify-mcp` の 2 コマンドが入ります。Python 3.10 以降が必要で、3 つのパッケージマネージャーのどれでも構いません。
# Python 3.10 or lateruv tool install graphifyy# or: pipx install graphifyy# or: pip install graphifyyつづりに注意:入れるのは `graphifyy`、打つのは `graphify` と `graphify-mcp` です。
スキルを登録する
フラグなしの `graphify install` は Claude Code を対象にします。スキルを `~/.claude/skills/graphify/SKILL.md` にコピーし、`~/.claude/CLAUDE.md` に登録します。別のエージェントなら `--platform` を渡します。
graphify install# Claude Code (default): ~/.claude/skills/graphify/SKILL.md# registered in ~/.claude/CLAUDE.md# another assistant: graphify install --platform codex例:`graphify install --platform codex`。それでも `/graphify` が認識されない場合はアシスタントを再起動するか、`~/.claude/skills/graphify/SKILL.md` の有無を確認してください。
リポジトリで実行する
アシスタントでリポジトリを開き、`/graphify .` を実行します。エージェントが detect、extract、cluster を行い、レポートを返します。コードはローカルで解析され、ドキュメントや論文はエージェント自身のモデルを通ります。
/graphify .そのあと質問します:`/graphify query "how does authentication reach the database"` は回答に必要なノードと辺だけをトークン予算に合わせて返します。
はじめる前に
- 1Python 3.10 以降。
- 2uv、pipx、pip のいずれか——CLI で普段使っているもので構いません。
- 3`graphify install` が対応するコーディングアシスタント(デフォルトは Claude Code)と、索引対象のリポジトリ——ローカルパス、または `/graphify <url>` 用の公開 GitHub URL。
実際に使うコマンド
ドキュメントの quickstart とコマンド表からの原文です。`/` で始まるものはアシスタント内で入力し、それ以外はシェルで実行します。
| コマンド | 何をするか |
|---|---|
/graphify query "…" | 質問する。回答に必要なノードと辺だけを、トークン予算に合わせて返します。 |
/graphify path "AuthModule" "Database" | 2 つのノード間の最短経路を表示します——ここでは AuthModule から Database。 |
/graphify explain "SessionStore" | 1 つのノードを説明します:何か、何とつながるか、なぜか。 |
/graphify . --update | 既存のグラフを更新します。ゼロから作り直しません。 |
/graphify . --mode deep | より深い抽出モードで実行します。遅い代わりに、より多くが解決されます。 |
/graphify . --wiki | グラフの wiki 風の解説も生成します。 |
/graphify https://github.com/<owner>/<repo> | ローカルパスの代わりに公開リポジトリの URL を指定します。 |
graphify hook install | git フック(post-commit、post-checkout、post-merge、post-rewrite と merge driver)を入れ、グラフをリポジトリに追随させます。`graphify hook status` で 4 つとも installed と表示されるはずです。 |
graphify god-nodes --top 5 | 最も多く接続されたノードを表示します。グラフが存在し妥当かどうかの簡易チェックになります。 |
graphify extract . --code-only | コードのパスだけで再抽出し、ドキュメントやメディアの LLM 処理を飛ばします。 |
graphify uninstall | スキルとその登録を削除します。 |
グラフが見つからない場合は、`graphify-out/` を含むディレクトリで実行するか、`--graph graphify-out/graph.json` を渡してください。
graphify-out/ に生成されるもの
ドキュメントのツリーをそのまま:
graphify-out/├── graph.json├── graph.html├── GRAPH_REPORT.md├── manifest.json└── cache/- 1`graph.json`——グラフ全体。他のツールがデータを読むときのファイルです。
- 2`graph.html`——ブラウザ表示:ノードをクリック、絞り込み、検索。
- 3`GRAPH_REPORT.md`——要点、意外なつながり、投げかけるべき質問。
- 4`manifest.json`——何を索引したかのマニフェスト。
- 5`cache/`——ローカルの作業データ。コミットせず `.gitignore` に入れます。
何をコミットするか
ドキュメントは `graph.json` と `GRAPH_REPORT.md` をコミットし、`cache/` を `.gitignore` に入れるよう勧めています。README の短い説明では「3 つのファイル」(`graph.html`、`GRAPH_REPORT.md`、`graph.json`)、quickstart では 5 項目。同じディレクトリを詳しさを変えて説明しているだけです。
保存されたグラフには `graph.schema_version` と `graph.graphify_version` も記録されます。CLI を更新したら確認してください。古いグラフは作り直しが必要な場合があります。
グラフを新鮮に保つ
グラフは最後のビルド時点の状態でしかありません。git につなぎましょう:
graphify hook installgraphify hook status# → 4 hooks installed, merge driver: registered`graphify hook install` は post-commit、post-checkout、post-merge、post-rewrite のフックと merge driver を設定します。その後 `graphify hook status` は 4 つのフックが installed、そして “merge driver: registered” と表示するはずです。
ドキュメントや画像が変わったら、全体を作り直さず `/graphify . --update` を実行します。
向く場面と、できないこと
Graphify はコードマップのツールです。1 つのファイルの文章より、リポジトリの形のほうが重要なときに効きます。
向いている場面
- 1なじみのないコードベースに入るとき、ファイルを読む前にモジュール、god node、コミュニティを見たい。
- 2質問が関係の質問——これはどうあれに届くのか、誰が呼んでいるのか——で、grep では答えにくい。
- 3マップをコミットしておき、チームやエージェントが再構築のコストを払わず読み返したい。
知っておきたい制約
- 1無料で完全ローカルなのはコードの部分です。ドキュメント、PDF、画像、動画の意味解析はモデルを通るため、トークンか API キーがかかります。
- 2`INFERRED` の辺は Graphify の解決結果で、ソースの事実ではありません。つながりを信じる前にタグを確認してください。
- 3グラフはスナップショットです。フックも `--update` も使わなければ、README と同じように古くなります。
- 4若いサードパーティプロジェクトです。その価値の根拠は独立した評価ではなく、自身の README にあります。
プロジェクトは README に独自のベンチマーク表を載せています——例:n=300 で LOCOMO recall@10 が 0.497。これはメンテナーの測定であって独立した結果ではないので、自分のリポジトリで確かめるべき主張として扱ってください。
DeepSeek Harness 上の Graphify
DeepSeek Harness 向けのサードパーティ製ネイティブプラグインもプラグインディレクトリに掲載されています。コミュニティの作品で、Graphify-Labs のリポジトリとは別です。
プラグインの掲載ページを見る