CLI
CLI reference
Complete aeon-cli command reference: builds, lanes, exec, cases, reports, coverage, copilot, tunnel, tokens, and global flags.
8 min read
Global flags
| Flag | Effect |
|---|---|
| --project <slug> | Override the project from aeon.yaml |
| --region <id> | Pin execution to a region (data residency) |
| --json | Machine-readable output for scripting |
| --quiet | Suppress progress rendering (use in CI) |
| --timeout <dur> | Client-side wait limit, e.g. 45m |
Command tree
texttext
aeon login | logout | whoami builds push | list | show | tag | rm lanes list | reserve | release | describe cases search | show | applicable exec run | attach | list | describe | tail | artifacts | cancel reports get | diff | verify coverage show | gaps trace clause copilot explain | ask tunnel up | down | status tokens create | list | rotate | revoke config lint | view | set
Scripting patterns
bashbash
# fail the shell when any case fails aeon exec run --campaign smoke --build "$GIT_SHA" --wait --exit-code # extract failures for a bug tracker aeon exec describe --id 4821 --json \ | jq -r '.cases[] | select(.verdict=="fail") | "\(.id)\t\(.reason)"' # wait for many runs for id in $(aeon exec list --state running --json | jq -r '.[].id'); do aeon exec tail --id "$id" --quiet & done; wait
Exit codes
| Code | Meaning |
|---|---|
| 0 | Success; all verdicts pass |
| 1 | At least one fail verdict |
| 2 | Usage or configuration error |
| 3 | Inconclusive verdict (environment) |
| 4 | Auth or quota error |
| 5 | Lane or platform error |
Run this against a real SDR lane
The tester is a service, not a box. Push a build, reserve a lane, get a verdict.