Skip to content llms.txt

permission_control

Whether hooks can make or influence permission decisions determining whether a tool is available for invocation. Minimum qualification: supported when the provider allows hooks to return permission decisions of any kind (grant, deny, or ask). Boundary: permission_control governs whether a tool is available; see decision_control for invocation-flow control.

Type: bool Content type: hooks

ProviderSupportedMechanism
ampamp.permissions ordered first-match-wins rule list returns one of allow / reject / ask / delegate for every tool invocation before execution; default fallback is ask on the main thread and reject in sub-agents
claude-codehook_permission_update_entries: PermissionRequest hooks return updatedPermissions with addRules/replaceRules/removeRules/setMode entries
codexhook_permission_decision: Codex hooks can return permission decisions that grant or deny tool availability
crushHooks run before permission checks. Exit code 2 blocks the tool call entirely, taking effect before the built-in permission gate.
factory-droidPreToolUse hooks return allow, deny, or ask in the JSON decision field to bypass, block, or escalate tool permission decisions
clineCline hooks can cancel tool invocations (decision_control) but cannot grant/deny tool availability
copilot-cliCopilot CLI hooks can deny tool invocations (decision_control) but do not govern tool availability
cursorCursor hooks control allow/block via exit codes but do not govern tool availability through permission rule updates.
gemini-cliGemini CLI hooks control invocation flow via exit codes but do not govern tool availability
kiroKiro hooks do not participate in permission decisions
opencodenot documented
piPi extensions cannot make availability decisions for tools; tool_call block controls invocation flow but does not remove a tool from the available set; setActiveTools() is available but is not a hook return mechanism
roo-codenot documented
windsurfWindsurf hooks do not participate in permission decisions
zednot documented