CLI Reference
Exit Codes
Every uxd exit code, the error name that goes with it, and what it means.
| Code | Name | Meaning |
|---|---|---|
0 | — | Success |
1 | E_INTERNAL | Unexpected internal failure |
2 | E_USAGE | Bad arguments or flags |
3 | E_CONFIG | Missing or invalid configuration |
4 | E_RESOLVE | The ref could not be resolved |
5 | E_GIT | A git or gh operation failed |
6 | E_SETUP | A setup step or hook failed |
Error output
Errors are one line on stderr, sometimes followed by a hint:
error(E_CONFIG): unknown project 'nope'
hint: known projects: demo-app
error(E_RESOLVE): branch 'does-not-exist' does not exist on origin
hint: check the name, or push the ref first
error(E_USAGE): unsupported shell 'ksh'
hint: one of: bash, zsh, fish
gh plumbing failures surface as E_GIT (exit 5), not as a separate code.Branch on the exit code, not on the message text — see Script with uxd for patterns, and Troubleshooting for fixes.