runbooks / command
Create a role
Registers a role with its parents, account and permissions
❯ /runbooks:roles:create [name] [--model <model>]❯ $runbooks:runbooks-roles-create [name] [--model <model>]Adds the role to <paths.runbooks>/roles.json and, for a ui stack, its login to accounts in the config. Read first: ${RUNBOOKS_PLUGIN_ROOT}/skills/runbooks/references/config.md, "Roles", and ${RUNBOOKS_PLUGIN_ROOT}/skills/runbooks/references/commits.md. The permission questions are those of ${RUNBOOKS_PLUGIN_ROOT}/commands/permissions/manage.md (step 2).
Parameters
Needs role tracking on. It asks the description, the parents, the account's env var names on a ui project, then the permissions, and shows the diff of roles.json and the config before it writes.
| Parameter | What it does |
|---|---|
[name] |
The new role, in kebab-case and not registered yet. Without it, the command asks. anonymous is built in and always registered. |
--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:create 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:create # asks the name
/runbooks:roles:create support-agent # a new role
/runbooks:roles:create --model sonnet # in a sonnet sub-agent