explain

terrabuild explain prepares the selected graph without executing it and prints why each target would execute, restore, summarize, or be ignored. The readable output is projected from the same canonical report used by --debug.

USAGE: terrabuild explain [--help] [--workspace <path>]
                          [--configuration <name>] [--environment <name>]
                          [--variable <variable>=<value>] [--label [<labels>...]]
                          [--type [<types>...]] [--project [<projects>...]]
                          [--force] [--retry] [--local-only]
                          [--engine <engine>] <target>...

Examples

terrabuild explain build
terrabuild explain build --project api
terrabuild explain deploy --environment staging
terrabuild explain build --force

For every selected node, the output includes its action and reason, dependency and cache evidence, cache key, evaluated input names, and resolved operation metadata. Values that could contain secrets remain hashed.