# Use CLI Codegraph

> codegraph CLI 経由でシンボル単位のコード構造を問い合わせる。呼び出し元、呼び出し先、変更の波及範囲、シンボルの定義元をたどる。

- Skill: `thkt/use-cli-codegraph-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add thkt/use-cli-codegraph-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/thkt/use-cli-codegraph-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: thkt (https://skillmd.com/u/thkt)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/thkt/use-cli-codegraph-2

---


# use-cli-codegraph

## 使いどころ

構造の問い合わせに限る。誰が X を呼ぶか、何が壊れるかといったシンボル単位の構造の問いを codegraph へ回し、自由記述の内容検索は Grep と Explore に残す。

| 問い                                       | ツール                                   |
| ------------------------------------------ | ---------------------------------------- |
| X を変えると何が壊れるか / 誰が X を呼ぶか | codegraph。Grep は構造をたどれない       |
| シンボルの定義元と呼び出し元 / 先の経路    | codegraph node / explore                 |
| 変更したファイルが影響するテスト           | codegraph affected                       |
| 自由記述や文字列の内容検索                 | Grep / Explore。codegraph はシンボル単位 |
| `.codegraph` index を持たないリポジトリ    | Grep / Explore。または init を促す       |

## コマンド

| 目的                                | コマンド                        |
| ----------------------------------- | ------------------------------- |
| 変更の波及範囲 (何が壊れるか)       | `codegraph impact <symbol>`     |
| 呼び出し元                          | `codegraph callers <symbol>`    |
| 呼び出し先                          | `codegraph callees <symbol>`    |
| シンボルの定義元と呼び出しの経路    | `codegraph node <name>`         |
| 領域の探索 (定義元と呼び出しの経路) | `codegraph explore <query...>`  |
| シンボル検索                        | `codegraph query <search>`      |
| 変更が影響するテスト                | `codegraph affected [files...]` |
| index の状態                        | `codegraph status`              |

## 前提

| 項目     | 詳細                                                                                                                               |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| index    | `.codegraph/` が要る。リポジトリごとに `codegraph init` を 1 回実行する。無い場合は init するか尋ねて止まる。黙って作らない        |
| 鮮度     | `codegraph status` が up to date を示す。大きな変更の後は `codegraph sync` を実行する。watcher daemon が動いていれば最新に保たれる |
| バイナリ | bun global で導入する。インストールや更新で EPERM が出たら `npm_config_cache=$TMPDIR/cg` を前置して回避する                        |

## 正典は help 出力

オプション、出力形式、終了コードは `codegraph --help` と `codegraph <subcommand> --help` にある。help と記憶が食い違えば help が正しい。