| name | codegraph |
| description | Initialize and use CodeGraph — pre-indexed knowledge graph for 92% faster code exploration. Auto-init when .codegraph/ missing. Use when exploring unfamiliar codebases, tracing call flows, or before editing. |
codegraph
Initialize CodeGraph when a project lacks .codegraph/, and use it as the PRIMARY code exploration method.
Auto-Init (when .codegraph/ is missing)
- Check installation:
codegraph --version
If not found → npm install -g @colbymchenry/codegraph
- Initialize and index the project:
codegraph init -i
- Verify:
codegraph status
Expected: Files: N, Nodes: N, Backend: native
- If
Backend: wasm (slow) → npm rebuild better-sqlite3
Using CodeGraph for Exploration
Once .codegraph/ exists, ALWAYS prefer CodeGraph MCP tools:
| Tool | What for |
|---|
codegraph_explore | Primary exploration — returns full source from all relevant files in one call |
codegraph_search | Find symbols by name |
codegraph_callers / codegraph_callees | Trace call flow |
codegraph_impact | Check what's affected before editing |
codegraph_node | Get single symbol details |
Rules
- Explore agents: pass this in prompt → "This project has CodeGraph. Use codegraph_explore as PRIMARY tool."
- NEVER re-read files codegraph already returned source for
- CodeGraph > grep/glob/Read/Find for any code understanding task
