CLI reference

All commands take --workspace and --environment flags, which fall back to the values in ~/.config/statera/config when omitted.

Global flags

Flag	Description
--workspace	Workspace name
--environment	Target environment
--output	text (default) or json
--quiet	Suppress non-error output

statera login

Authenticate and store credentials.

statera login --workspace acme

statera apply

Validate a file and roll it out.

statera apply <file> [--wait] [--canary <percent>]

Flag	Default	Description
--wait	off	Block until the rollout completes
--canary	10	Initial rollout percentage

statera validate

Check a file against the schema without applying it.

statera validate <file>

statera get

Show the live state of a service.

statera get <service> [--revision <n>]

statera rollout

Inspect and control an in-progress rollout.

statera rollout status <service>
statera rollout pause  <service>
statera rollout resume <service>

statera rollback

Return a service to an earlier revision.

statera rollback <service> --to <revision>

Exit codes

Code	Meaning
0	Success
1	Validation failed
2	Rollout failed a health check
3	Authentication error