gp_callers
List all callers of a symbol to find dependents before renaming, or all callees to understand dependencies. Uses a pre-indexed reverse map for sub-millisecond results.
Instructions
List every caller of a symbol (direction=callers) or everything it calls (direction=callees). ALWAYS use instead of grep -rn "X(" for "who calls X?" — pre-indexed reverse map, sub-millisecond, no false positives from comments or strings. Use direction=callers to find dependents before a rename; direction=callees to understand what a function depends on. Do NOT use for full blast-radius analysis across multiple hops — use gp_impact instead.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | Symbol name or full id. | |
| direction | No | Default 'callers'. | |
| limit | No | Max edges (default 50). | |
| includeUnresolved | No | Include external/stdlib calls (default true). | |
| path | No | Repo root with a GraphPilot index. Optional: when omitted, resolves via GRAPHPILOT_ROOT, MCP workspace roots, parent walk, or a single ~/.graphpilot index. |