fleet-runtime CLI reference

Execute complete Task inputs, coordinate durable Runs, and inspect sealed Attempts.

On this page

User command groups

Command	Purpose
`fleet-runtime taskset validate\|show\|digest SOURCE`	Validate or inspect TaskSet input before execution.
`fleet-runtime runs submit (REF \| --prompt TEXT) -n N`	Create a local or hosted Run.
`fleet-runtime runs work RUN_ID`	Execute the eligible rollout work in one admitted Run.
`fleet-runtime runs list`	List admitted Runs.
`fleet-runtime runs status RUN_ID`	Show one Run’s current lifecycle status.
`fleet-runtime runs show RUN_ID [--rollouts \| --journal]`	Render one Run’s flow, rollout records, or event journal.
`fleet-runtime runs report RUN_ID`	Build a report snapshot with the requested success policy and statistics.
`fleet-runtime runs retry RUN_ID ROLLOUT_KEY`	Manually reopen one eligible failed rollout.
`fleet-runtime runs cancel RUN_ID`	Stop new claims, signal active holders, and finalize the Run as cancelled without interrupting an attempt mid-execution.
`fleet-runtime inspect (ATTEMPT_ID \| --latest [--task TASK_KEY] [--run RUN_ID])`	Inspect one Attempt and its sealed evidence.
`fleet-runtime verify (ATTEMPT_ID \| --latest [--task TASK_KEY] [--run RUN_ID]) (--list \| --verifier FILE \| --verifier-id ID)`	List persisted verification runs or re-verify one sealed Attempt without rerunning the agent.
`fleet-runtime env preview\|check\|serve SOURCE`	Preview declarations, prepare and smoke-check then tear down, or prepare and hold Environments open.
`fleet-runtime env ps`	List durable prepared-Environment leases.
`fleet-runtime session serve SOURCE`	Prepare one Attempt and serve it over MCP to an external agent.
`fleet-runtime contracts schema NAME`	Print one Runtime contract JSON Schema for advanced integration work.

Run submission and inspection

Terminal

fleet-runtime runs submit REF -n N --agent KIND --follow
fleet-runtime runs submit --prompt TEXT -n N --agent KIND --follow
fleet-runtime runs show RUN_ID --rollouts
fleet-runtime runs show RUN_ID --journal
fleet-runtime runs report RUN_ID --statistic pass@1
fleet-runtime runs retry RUN_ID TASK_KEY#0

Submission also supports Task selection, agent options, harness variables, pre-execution checks, a Runtime root, and a named target. JSON is exposed per command, not as one global versioned Runtime envelope.

Attempt selection and verification

Terminal

fleet-runtime inspect ATTEMPT_ID [--target NAME]
fleet-runtime inspect --latest [--task TASK_KEY] [--run RUN_ID]
fleet-runtime verify ATTEMPT_ID --list [--target NAME]
fleet-runtime verify ATTEMPT_ID --verifier FILE [--supersedes VERIFICATION_RUN_ID]
fleet-runtime verify ATTEMPT_ID --verifier-id ID [--supersedes VERIFICATION_RUN_ID]

--supersedes identifies a prior verification run for the same Attempt, never the parent evaluation Run.

Operator and developer commands

Stability boundary

Runtime commands are source-defined for the current release. Consult the installed command’s --help before scripting options; unlike the Registry clients, this page does not claim a single global machine-output envelope.