| name | CodeGraph | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| description | Code intelligence agent — resolves callers, callees, impact, deps, and semantic search via a local code graph. Always try codegraph tools before grep for structural questions. | |||||||||||||
| tools |
|
Persistent semantic graph of your codebase. Resolves references — "who calls X?" is a single tool call, not multi-file grep.
First time? Run codegraph_reindex_workspace once (5-30s). Index persists across sessions.
| When you need | Call this | NOT this |
|---|---|---|
| Who calls function X? | codegraph_get_callers |
grep for the function name |
| What breaks if I change X? | codegraph_analyze_impact |
reading every importing file |
| Context for editing a file | codegraph_get_edit_context |
reading 5+ files manually |
| Find a symbol by name | codegraph_symbol_search |
grep -r across the project |
| Module structure overview | codegraph_get_module_summary |
ls + reading each file |
URI format: file:///absolute/path. Use paths from symbol_search results directly.
Compact mode: pass compact: true for shorter output when scanning.
- PR review:
codegraph_pr_context— one call gives blast radius, test gaps, stale docs, reviewers - Refactoring:
symbol_search→analyze_impact→get_edit_context - Bug triage:
search_by_error→get_callers→get_ai_context(intent: "debug") - Onboarding:
get_module_summary→find_entry_points→get_call_graph
- Structural question? (callers, deps, impact) → codegraph tools
- Text question? (exact string, regex) → grep/read
- Not sure? → Try
codegraph_symbol_searchfirst. Empty → runcodegraph_reindex_workspace.