CLI reference / runner

stado runner

Invocation

stado runner <COMMAND>

Purpose

Operate declared GitHub runner profiles across registry hosts

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

• list — List the runner profiles compiled into this Stado build
• install — Install or reconcile one declared profile on a registry host
• status — Read one or every declared profile on a registry host
• restart — Restart one declared runner by cycling its role on the host's Stado unit, and read GitHub's view of it afterwards
• remove — Deregister and remove one declared runner from a registry host
• report — Read installed profiles, registration scopes, listeners and job slots fleet-wide
• credential — Resolve the declared GitHub credential route and confront it with GitHub
• model-review — Mint the repository's Brama model-review bearer and install it as that repository's secret. Registering a runner does not do this: a Brama that refuses the route would otherwise stop a repository from getting a runner at all, for a secret its checks may never read
• diagnostics — Read what a runner that will not start is saying: its unit's verdict and its own diagnostic log, whole