Reference
Automation behavior
stdout, stderr, confirmations, timeouts, retries, and exit codes.
- Primary JSON results go to stdout.
- Output is always JSON; no format flag is required.
- Progress, warnings, and diagnostics go to stderr.
--no-inputand--non-interactivedisable prompts but do not authorize an action.--yesonly bypasses a specific confirmation.- Every mutation supports
--dry-run. - Timeouts require units such as
500ms,30s, or2m. - Success exits with code
0; meaningful failure classes use documented nonzero codes.
For unattended calls, disable prompts and set a timeout:
--no-input --timeout 30sAlways inspect both the process exit code and the envelope's ok field. Before
retrying a failure, inspect error.retrySafety. Never automatically retry
unsafe or never failures.