runbooks / command
Delete a role
Removes a role from the registry, the config and the runbooks that cite it
❯ /runbooks:roles:delete <name> [--model <model>]❯ $runbooks:runbooks-roles-delete <name> [--model <model>]Removes the role from <paths.runbooks>/roles.json, accounts.<name> from the config and every line that names the role from the runbooks. 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
Lists the runbooks that cite the role and the roles that inherit from it before it writes anything. For heirs, it asks whether to copy what they inherited or let them lose it.
| Parameter | What it does |
|---|---|
<name> |
The role to delete. anonymous cannot be deleted. |
--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:delete 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:delete support-agent # remove a role everywhere
/runbooks:roles:delete support-agent --model sonnet # in a sonnet sub-agent