CLI reference / change / list

stado change list

Invocation

stado change list [OPTIONS] [CHECKOUT]

Purpose

List the candidates of the checkout's repository, or of every repository without one, in the queue's order: those moved ahead with `stado change prioritize` first, then oldest first

Required inputs and options

Input or optionContract
[CHECKOUT]A repository's checkout on this machine; every repository without it
--state <STATE>Only candidates in this state: queued, running, landed, refused, repaired or cancelled
--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

  • Only candidates in this state: queued, running, landed, refused, repaired or cancelled
  • 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.