Skip to content
Unofficial community docs. Content pulled on 2026-10-24 from Trail-Code@d205ac3. For the latest, see the official repo.

Enable deep mode

By default, trail build uses tree-sitter: every symbol and call edge, no model, no key. trail build --deep adds plain-English summaries of each part of the system, written by the model provider you choose, under your own key.

trail build trail build --deep
Every function, class, and call edge (tree-sitter) ✅ ✅
Per-file wiring cards ✅ ✅
Concept nodes (file summaries + node synthesis) ✅
Per-symbol one-line summary and crux excerpt ✅
  1. Set your provider

    Terminal window
    export GRAFT_PROVIDER=openai # or anthropic, litellm, orcarouter
    export GRAFT_API_KEY=<your key>
    export GRAFT_MODEL=<model>

    See Configure providers.

  2. Run the deep build

    Terminal window
    trail build --deep

    To summarize only some extensions:

    Terminal window
    trail build --deep -e .ts .py

Every pass is cached by content hash, so re-running only touches the files that changed.