Skip to content

runbooks / command

Check a runbook's latest run

Shows the result of a runbook's latest run, or says it was never run

❯ /runbooks:check <id> [--full] [--model <model>]

This command only reads. It opens no browser, writes no file and commits nothing.

By default the latest run is the newest report of the id, partial runs (--steps) included.

Parameters

Parameter What it does
<id> The runbook, as <capability>.<flow>.
--full Skip partial runs (--steps) and show the newest full run, the one last_run records. Without it, the newest report wins.
--model <m> Run this invocation on one model: inline (in the main session), haiku, sonnet, opus or fable. Any value but inline runs the command in a sub-agent on that model. Without it, the command takes its row of the models table in the config: by default check runs inline. On Codex, the values are inline, inherit (a sub-agent on the session's model) or a model ID the session supports, and the table is codex.models, where every row that is not inline defaults to inherit. See models.
/runbooks:check billing.issue-invoice                 # newest report, partial or not
/runbooks:check billing.issue-invoice --full          # newest full run
/runbooks:check billing.issue-invoice --model sonnet  # in a sonnet sub-agent

View source on GitHub