Skip to main content
Three commands move an agent between deployment stages. Each accepts --build and --version so you can build and stage in one step.
pilot and live run with real side effects. Both prompt for confirmation. --yes skips the prompt.

jstm agent dry-run

Set the agent’s stage to Dry Run and, unless you pass --no-run, fire one dry-run run.
Dry Run executes the agent end to end with side-effecting actions held back. Nothing outside JoyStream changes.

jstm agent pilot

Promote the agent to the Pilot stage.
Pilot is controlled real execution — limited scope, access, volume, or audience. Actions take effect.

jstm agent live

Promote the agent to the Live stage.
Takes the same options as pilot. Live is approved production execution.

Choosing a version

Without --version, staging uses the agent’s current package. With it, you pin an exact version:
Combining --build --version 0.3.0 builds that version and stages it in one command.

Checking readiness first

jstm agent readiness exits non-zero when there are blockers, so it gates a promotion cleanly:
See Inspect an agent.

Running after staging

Once staged, jstm agent run with no --mode uses the agent’s current stage. A plain run on a pilot-staged agent runs as pilot, not as an implicit dry run.
See jstm agent run.

See also