graphify（Graphify-Labs/graphify）：コード・文書・PDFをナレッジグラフ化し、Claude Codeから質問・経路探索できるスキル

graphify（Graphify-Labs/graphify）は、プロジェクトのコード・文書・PDF・画像・動画を「ナレッジグラフ」に変換し、ファイルを一つずつ読む代わりにグラフへ問い合わせられるようにするツールです。Claude Codeのスキルとして登録し、チャット欄で「/graphify .」と入力して使います。コードの規模が大きく、Claudeが関連ファイルを探すだけでトークンを消費している開発者や、複数のシステムの設計資料・ソースを横断して把握したい運営者が対象です。Apache-2.0ライセンスで公開されています。

何ができるか
導入方法
注意点
まとめ

何ができるか

「/graphify .」を実行すると、対象フォルダの内容を解析して graphify-out/ フォルダに3つのファイルを出力します。graph.html はブラウザで開けるグラフ表示、GRAPH_REPORT.md は主要な概念や意外な結びつきをまとめたレポート、graph.json はグラフ全体のデータです。graph.json ができれば、ファイルを読み直さずに何度でも問い合わせられます。

問い合わせには3種類のコマンドがあります。「graphify query」は自然文の質問に対して関連部分のグラフを返し、「graphify path A B」は2つの要素のつながりを最短経路で示し、「graphify explain」は1つの概念の接続先を一覧します。各つながりには、ソースに明記されている「EXTRACTED」と、graphifyが解決して推定した「INFERRED」のタグが付き、直接読み取った情報か推定かを区別できます。READMEによれば、ベクトル検索や埋め込みは使わず、グラフをたどる方式です。

コードの解析にはtree-sitterによる構文解析（READMEの記載では約40言語）を使います。そのためコードのみを対象にする場合、LLMもAPIキーも不要で、外部へ送信されません。ドキュメント、PDF、画像は、使用中のAIアシスタントのモデルによる意味抽出を経てグラフに加わります。

導入方法

PyPIのパッケージ名は「graphifyy」（yが2つ）です。READMEは、同名に近い他の「graphify」系パッケージは公式と無関係だと注記しています。READMEが推奨するのはuvによるインストールです。

# CLIをインストール（pipx install graphifyy でも可）
uv tool install graphifyy

# 「graphify: command not found」になる場合
uv tool update-shell

# Claude Codeにスキルを登録
graphify install

登録後、Claude Codeを開いて対象プロジェクトで次のように入力します。

/graphify .

スキルをユーザー全体ではなく特定のリポジトリだけに入れたい場合は「graphify install –project」を使います。この場合 .claude/skills/graphify/ 以下にファイルが作られ、Gitで共有できます。PDFやWord・Excel、動画を扱うには、追加の機能を指定します。

uv tool install "graphifyy[pdf]"      # PDF
uv tool install "graphifyy[office]"   # .docx / .xlsx
uv tool install "graphifyy"    # 動画・音声の文字起こし
uv tool install "graphifyy[mcp]"      # MCPサーバーとして使う場合

常時利用向けの補助機能もあります。「graphify hook install」はコミット後などにグラフを更新するGitフックを入れ、「graphify claude install」はCLAUDE.mdへの指示とPreToolUseフックを追加します。「graphify install –project –strict」では、セッションの最初のソース読み込みを止めてグラフ参照に誘導します。Cursor、Codex、Gemini CLIなど20以上のアシスタントにも対応しています。

注意点

外部通信の範囲：コードはローカルで解析されます。文書・PDF・画像は、スキル経由ならClaude Codeが使うモデルに送られます。
APIキー：スキルを使わずに「graphify extract」を単独実行して文書類を処理する場合、Gemini、Kimi、Claude、OpenAIなどのAPIキー環境変数が必要です。複数のキーが設定されていると、README記載の優先順（Gemini→Kimi→Claude→OpenAI→DeepSeekなど）で提供元が自動選択されます。意図しない送信先にならないよう、キーの設定状況を確認してください。Kimi（MOONSHOT_API_KEY）は中国のサーバーに送信されると明記されています。
機密データ：データの所在地に要件があるコードや文書は、「–backend ollama」でローカルのOllamaを使う方法がREADMEに示されています。コードのみなら「–code-only」で文書類の送信を避けられます。
ログ：テレメトリや利用状況の収集はないと記載されています。一方、query・path・explainの質問内容は ~/.cache/graphify-queries.log に記録されます。止めるには環境変数 GRAPHIFY_QUERY_LOG_DISABLE=1 を設定します。
設定ファイルの変更：フック系のコマンドはCLAUDE.mdやフック設定、Gitフックを書き換えます。導入前に既存設定のバックアップを取っておくと安心です。
有料サービスの案内：READMEには、常時更新型のクラウド版（graphify.com、14日間無料試用）の案内があります。本記事で扱ったCLIとスキルは、これとは別にローカルで動作します。