Enable Deep Mode

By default, graft build uses tree-sitter for deterministic, model-free structural parsing. The --deep flag adds a second pass that uses an LLM to generate richer summaries.

What deep mode adds

Feature	Standard build	Deep build
File structure & symbols	✅	✅
Call graph & dependencies	✅	✅
Per-symbol one-line summaries	❌	✅
Concept nodes	❌	✅
“Crux” architectural insights	❌	✅

Enable deep mode

1. Set your LLM provider credentials

   export GRAFT_PROVIDER=openai      # or anthropic, ollama, openrouter, google
   export GRAFT_API_KEY=your-key

   See Configure Providers for all supported providers.

2. Run the deep build

   graft build --deep

   The first deep build summarizes every source file, then groups summaries into curated nodes. Results are cached by content hash — subsequent builds only re-process changed files.

Caution

Deep mode calls your LLM provider and incurs API costs. The standard graft build (without --deep) is free, deterministic, and needs no API key.

See also

• Configure Providers — Set up OpenAI, Anthropic, Ollama, and more.
• Environment Variables Reference — All GRAFT_* environment variables.
• How the Graph Works — Architecture of the two-pass build.