codegraph

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)

1. Check installation:

codegraph --version

If not found → npm install -g @colbymchenry/codegraph

2. Initialize and index the project:

codegraph init -i

3. Verify:

codegraph status

Expected: Files: N, Nodes: N, Backend: native

4. 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