CLI reference / machine

stado machine

Invocation

stado machine <COMMAND>

Purpose

Stable JSON machine interface

Required inputs and options

This command has no command-specific inputs or options.

Output and state effect

This command group selects one of the subcommands listed below; use its exact child invocation to perform an operation.

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.

Subcommands

• submit — Submit one idempotent request from a JSON file
• status — Read one job directly by ID; `--until terminal` holds the read until the job ends
• logs — Read the canonical command log from a byte cursor: to the end, or at most --limit bytes
• cancel — Durably and idempotently cancel one job
• artifacts — Download and verify canonical artifacts for a terminal job