Output, errors & exit codes

Human output

Pretty text by default (tables / checkmarks). Set NO_COLOR=1 to disable ANSI.

JSON envelope

awsutopia list --json

Success:

{ "ok": true, "data": { } }

Failure:

{
  "ok": false,
  "error": {
    "code": "NO_PROJECT",
    "message": "…",
    "hint": "…"
  }
}

Errors always include { code, message, hint } — enough to fix it without guessing. Hint may be omitted only for unexpected DEBUG stacks.

Exit codes

Code	Meaning
0	Success
1	Generic / runtime
2	Usage / validation
3	Auth / credentials
4	Not found
5	Denied / confirmation declined

DEBUG=1 prints stack traces (hidden by default).