Skip to content

Tool & Shell Permissions

Permissions refine access inside hard sandbox boundaries.

FieldPurpose
permissions.toolsAllow, ask, or deny exposed tools such as context7_search or wildcard patterns like context7_*.
permissions.shellAllow, ask, or deny shell commands or command classes.
permissions.tools.request_filesystem_accessControls whether the agent may request extra filesystem access.

Permissions can require approval or deny an action. They cannot widen filesystem or network hard boundaries.

workspace and readonly ship with the same shell permission table:

PatternAction
bash -cask
bash -lcask
chmodask
chownask
ddask
find -deleteask
git pushask
git reset --hardask
mkfsask
node -eask
python -cask
python3 -cask
rm -frdeny
rm -rask
rm -rfdeny
sh -cask
sudoask
zsh -cask
zsh -lcask

danger ships with no default shell permission rules.

If request_filesystem_access is not configured, the agent may request access, but the user still has to approve and protected paths remain protected.

{
"permissions": {
"tools": {
"request_filesystem_access": "ask",
"context7_*": "allow"
},
"shell": {
"npm run build": "allow",
"curl *": "ask"
}
}
}