CLI reference / build / status

stado build status

Invocation

stado build status [OPTIONS] <BUILD_ID>

Purpose

Read one build: its source, and what each platform's job did

Required inputs and options

Input or optionContract
<BUILD_ID>Full build ID from `stado build submit` or `stado build list`
--waitHold until every platform's job is queued and then ended, so the answer is `passed` or `failed`, never `waiting`; woken by the local store's change watch, not a timer
--jsonCommand option; required or optional as shown in the invocation.

Output and state effect

This is an inspection/reporting operation. It emits the result described above and does not change managed state unless an explicit option in this page says otherwise. Pass `--json` when the command exposes that machine-readable option.

Refusals

  • Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.