codegraph

Local code graph exposed as 8 MCP tools. Accelerates exploration with O(1) SQLite lookups and FTS5 search — slashing the grep + Read loops needed to orient in a codebase.

It does not replace grep. Codegraph is a tree-sitter approximation of the call graph, not a compiler-grade one: it is fast and low-token but unsound (it has false negatives). Treat it as the accelerator for orientation and traversal, and keep grep as the source of truth for completeness. See Soundness & limits below — this distinction is load-bearing, not a footnote.

When to use

• Brownfield repo where structure is non-obvious
• Task involves: "where is X used", "what breaks if I change Y", "trace flow from A to B"
• Long-running session — cold-start cost amortizes over multiple queries

When NOT to use

• Single-file edits or trivial lookups
• Session likely shorter than cold-start cost (see references/spike.md for per-repo numbers)
• Repo not initialized AND no cached .codegraph/ AND short session

Soundness & limits — read before trusting a result