| Code |
Meaning |
| 0 |
Success, also with lint warnings |
| 1 |
Something failed, or dta diff --fail-on-change found something to look at |
| 2 |
Invalid input: the config, credentials or files a command needs, or lint errors |
| Command |
1 |
2 |
| every command |
no config file found, or it cannot be loaded; unknown command or option |
the config is invalid (unknown key, wrong type) |
dta pull |
the Figma request failed; the received files have errors |
no Figma credentials for an API pull; --from-file not found, not JSON, in an unknown format or not convertible |
dta push |
unknown --format; token files invalid; the Figma request failed; the plan has errors |
tokens folder missing or empty; lint errors (without --skip-lint); no Figma credentials |
dta build |
token files cannot be read or built (also a dangling or circular alias); nothing is written |
|
dta lint |
tokens folder missing; token files invalid |
lint errors |
dta analyze |
the Figma request failed |
no Figma credentials |
dta init |
with a config: it cannot be read |
--diff without a config (cancelling exits with 0) |
dta diff |
the base cannot be resolved or does not build; the build or a story failed; no browser with CI set; a publish hook failed; --fail-on-change with something to review; --check: a check failed |
|
dta token |
unknown name (get); no token has the value (find); tokens folder missing or token files invalid |
unknown --format, --type, collection or mode |
dta skill add |
--check: the installed skill is missing or out of date |
the target SKILL.md was not written by dta skill add (it is left unchanged) |
dta context |
tokens folder missing or token files invalid; --check: DESIGN.md or the AGENTS.md block is missing or out of date |
the context file exists and was not written by dta context (it is left unchanged) |
dta audit |
hard-coded values that equal a token, not in the baseline |
a path not found; unknown --format; tokens folder missing or token files invalid; the baseline is not valid |
dta diff --fail-on-change exits 1 when stories changed in a way that needs a look (unexplained changes above the threshold, explained ones not yet approved, added or removed stories); without stories, on any token change. See dta diff in pull requests.