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.
What deep mode adds
Section titled “What deep mode adds”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 | ✅ |
Run a deep build
Section titled “Run a deep build”-
Set your provider
Terminal window export GRAFT_PROVIDER=openai # or anthropic, litellm, orcarouterexport GRAFT_API_KEY=<your key>export GRAFT_MODEL=<model>See Configure providers.
-
Run the deep build
Terminal window trail build --deepTo 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.