opschain runs
Included from Basic tier
The run family: one verb set over both run kinds — a change (one action
on one target node) and a workflow run (an orchestration of steps).
Every id-taking verb works for both kinds where both exist: the change
family is tried first and a not-found falls through to the workflow-run
family, so you never tell the CLI which kind an id is. Creation and
execution are runs create's two lanes (local repository vs server);
everything else inspects or steers an existing run.
| Subcommand | Purpose | Manual |
|---|---|---|
runs list | List runs, newest first — both kinds in one table | opschain docs cli/runs-list |
runs show | One run: header, step tree, optionally its audit events | opschain docs cli/runs-show |
runs logs | A run's logs — opschain logs registered in the run family | opschain docs cli/runs-logs |
runs create | The creation verb — two subcommands, two lanes | opschain docs cli/runs-create |
runs create change | Execute an action locally, or create a change on a server node | opschain docs cli/runs-create-change |
runs create workflow | Execute a workflow locally, or run a project's stored workflow on a server | opschain docs cli/runs-create-workflow |
runs retry | Retry a run as a new duplicate run, attached | opschain docs cli/runs-retry |
runs cancel | Cancel a run | opschain docs cli/runs-cancel |
runs pause | Hold a server run before its next step | opschain docs cli/runs-pause |
runs resume | Release a paused server run | opschain docs cli/runs-resume |
runs approve | Approve a run's waiting approval step (server) | opschain docs cli/runs-approve |
runs continue | Continue a run's waiting step (server) | opschain docs cli/runs-continue |
runs reject | Reject a run's waiting step (server) | opschain docs cli/runs-reject |
runs converged | The properties (or settings) a change converged, with per-value attribution | opschain docs cli/runs-converged |
runs artifacts | A run's stored artifacts — list, or download one by name | opschain docs cli/runs-artifacts |
See also
opschain learn 3.1(changes on a server) andopschain learn 4.1(workflows) — the guided tours of this family.opschain docs fleet-queue— where created server runs queue and why they might not dispatch.