runbooks / command
What's next
Not sure which command to run? It reads your runbooks, your code and your latest changes, and suggests three commands with the reason for each.
❯ /runbooks:whats-next [--since <ref>] [--model <model>]❯ $runbooks:runbooks-whats-next [--since <ref>] [--model <model>]/runbooks:whats-next answers one question: given the runbooks, the code and what the latest changes touched, which command makes the most sense to run now? The answer is three commands, ready to copy, each with the facts that put it there: a script output, a file, a line of the diff. It makes no suggestion it cannot back with one.
It is read-only until you pick a suggestion: it runs no runbook, writes no file and commits nothing. When you pick one, that command runs with the arguments shown, and writes and commits by its own rules.
The reading runs in a sub-agent, on sonnet by default. The main session prints the three suggestions and asks which one to run. The command you pick then runs on the model of its own row in the models table, and --model given to whats-next carries over to it.
Parameters
Read-only until you pick a suggestion: it runs no runbook, writes no file and commits nothing. Each suggestion quotes the facts behind it. When you pick one, that command runs and writes and commits by its own rules.
| Parameter | What it does |
|---|---|
--since <ref> |
The base of the changes to read: HEAD~3, develop or a commit. Without it, the base is git.base on any other branch, and the last commit (HEAD~1) on git.base itself. Uncommitted and untracked files always count. |
--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 whats-next runs on sonnet. 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:whats-next # changes since git.base, or the last commit on it
/runbooks:whats-next --since HEAD~5 # the last five commits
/runbooks:whats-next --since develop # everything since develop
/runbooks:whats-next --model opus # on opus, this time only