runbooks / command
Update a role
Changes a role's description, parents or account, or renames it
❯ /runbooks:roles:update <name> [--model <model>]❯ $runbooks:runbooks-roles-update <name> [--model <model>]Changes the role's entry in <paths.runbooks>/roles.json and, for an account or a rename, accounts in the config. Permissions have their own command, /runbooks:permissions:manage. Read first: ${RUNBOOKS_PLUGIN_ROOT}/skills/runbooks/references/config.md, "Roles", ${RUNBOOKS_PLUGIN_ROOT}/skills/runbooks/references/format.md, "Roles" and "Review", and ${RUNBOOKS_PLUGIN_ROOT}/skills/runbooks/references/commits.md.
Parameters
Permissions have their own command, /runbooks:permissions:manage. A change of parents changes the role's permissions and its heirs', so the command lists the runbooks it reaches and offers to mark them for review.
| Parameter | What it does |
|---|---|
<name> |
The role to change: its description, parents, account or name. A rename rewrites every runbook line and fixture folder that names the role. anonymous cannot be renamed, given an account or given parents. |
--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 roles: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:roles:update manager # change the manager role
/runbooks:roles:update manager --model sonnet # in a sonnet sub-agent