Update a context

Changes a context's keys, cases or description, and marks the runbooks the change reaches for review

❯ /runbooks:contexts:update [name] [--model <model>]

❯ $runbooks:runbooks-contexts-update [name] [--model <model>]

Edits <paths.runbooks>/roles.json and, for a renamed or deleted case, the runbooks and their +<case> fixture folders. Marks affected runbooks with review. A context is a question about the record that changes what a role may do on some keys, and a case is one answer to it. Read first: ${RUNBOOKS_PLUGIN_ROOT}/skills/runbooks/references/config.md, "Roles", and ${RUNBOOKS_PLUGIN_ROOT}/skills/runbooks/references/format.md, "Review". Commit policy: ${RUNBOOKS_PLUGIN_ROOT}/skills/runbooks/references/commits.md.

Parameters

A renamed case changes roles.json, the runbooks and the +<case> fixture folders in one write. A deleted case leaves every cases list, Cases: line and role line. A new key or case marks its runbooks for review.

Parameter What it does

[name] The context whose keys, cases or description change. Without it, the command lists the contexts and asks.

--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 contexts:update 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.

Parameter	What it does
`[name]`	The context whose keys, cases or description change. Without it, the command lists the contexts and asks.
`--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 `contexts:update` 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:contexts:update                 # asks which context
/runbooks:contexts:update client-access   # change one context
/runbooks:contexts:update --model sonnet  # in a sonnet sub-agent

View source on GitHub