Permissions cheat sheet
Kiro CLI v3 capability rules. Source: kiro.dev/docs/permissions.
Rule anatomy
rules:
- capability: shell # what kind of operation
match: ["npm *"] # glob(s)
exclude: ["npm publish*"]# must NOT match
effect: allow # deny | ask | allow | evaluate
Where rules live
| Scope | Location |
| user | ~/.kiro/settings/permissions.yaml |
| workspace | ~/.kiro/workspace-roots/<hash>/permissions.yaml (outside the repo) |
| agent | permissions field in the agent profile |
| session | In memory (from approval prompts) |
Resolution
deny > ask > allow > evaluate. No scope precedence; most restrictive wins.
v2 to v3 map
| v2 | v3 |
allowedCommands / deniedCommands (regex) | shell match (glob), allow / deny |
denyByDefault: true | shell exclude list with deny |
allowedPaths / deniedPaths | fs_read / fs_write match |
allowedTools, /tools trust | rules; session-wide: --trust-all-tools or /tools trust-all |
use_aws | Removed; use an AWS MCP server or shell rules |
| Headless narrow trust | --no-interactive --trust-tools=read_file,grep_search (exact tool IDs) |
Glob rules
| Capability | Syntax |
| fs_read, fs_write | * within a component, ** across, {a,b}, [abc]; no-wildcard path matches children |
| shell, web, mcp | * only (any characters) |
Useful commands
/permissions # view and change policies (incl. Approve for me)
/upgrade-agent # convert v2 agents; backs up originals
/upgrade-agent diagnostics # conversion warnings
kiro-cli agent validate --path .kiro/agents/my-agent.json