runbooks / command
List roles
Lists the roles, or shows one with its effective permissions
❯ /runbooks:roles:list [name] [--json] [--model <model>]❯ $runbooks:runbooks-roles-list [name] [--json] [--model <model>]Read-only. It writes nothing and commits nothing. The registry and the matrix: ${RUNBOOKS_PLUGIN_ROOT}/skills/runbooks/references/config.md, "Roles".
Parameters
Read-only: it writes and commits nothing.
| Parameter | What it does |
|---|---|
[name] |
Show one role instead of the list: its effective permissions, where each action comes from (its own, inherited or overridden), and its runbooks. |
--json |
Print the rows as JSON, for scripts. |
--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:list 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:list # every role
/runbooks:roles:list manager # one role and its permissions
/runbooks:roles:list --json # as JSON
/runbooks:roles:list --model sonnet # in a sonnet sub-agent