use-cli-codegraph

# use-cli-codegraph ## When to use Structural queries only. Route symbol-level structure questions like who calls X or what breaks to codegraph, and keep free-text content search on Grep / Explore. | Question | Tool | | --------------------------------------- | ----------------------------------------- | | What breaks if I change X / who calls X | codegraph; Grep cannot trace structure | | Symbol definition + caller/callee trail | codegraph node / explore | | Tests affected by changed files | codegraph affected | | Free-text or string content search | Grep / Explore; codegraph is symbol-level | | Repo without a `.codegraph` index | Grep / Explore, or prompt to init | ## Commands | Purpose | Command | | ---------------------------------- | ------------------------------- | | Change impact (what breaks) | `codegraph impact <symbol>` | | Callers | `codegraph callers <symbol>` | | Callees | `codegraph callees <symbol>` | | Symbol source + call trail | `codegraph node <name>` | | Explore area (source + call paths) | `codegraph explore <query...>` | | Symbol search | `codegraph query <search>` | | Tests affected by changes | `codegraph affected [files...]` | | Index stat...