Permissions - FoysalAhammad/agent24 GitHub Wiki

๐Ÿ” Permissions

Every tool sits behind a permission key. Three values:

Value Badge Meaning
allow โœ… runs immediately
ask โ“ popup appears โ€” Deny ยท Always ยท Allow โ€” and waits
deny โŒ blocked completely

๐Ÿ—๏ธ Permission keys

Key What it gates
read reading files
edit write, edit, apply_patch
bash bash, shell
glob, grep, list search tools
task subagent delegation
webfetch, websearch internet tools
skill, question, todowrite their tools
sensor device/sensor control
external_directory anything outside the workspace
doom_loop recovery when the agent is stuck

๐Ÿงญ Evaluation order

  1. Session grant from a previous Always
  2. Safe-command allow-list (read-only shell commands)
  3. Glob rules from tui.json (app_settings.permissions.<tool>)
  4. Agent default โ€” build * โ†’ allow, plan โ†’ ask

๐Ÿ”” On first launch

The app asks for everything it needs once: storage, camera, battery exemption and all-files access โ€” no hunting through settings later.

๐Ÿ›ก๏ธ Built-in denials

rm -rf /, sudo, su, mkfs, dd, world-writable chmods and secret files (.env, *.pem, *.key) are denied by default, and Always grants reset when you start a new session or restart the app.


๐Ÿ  Home ยท Docs site ยท Repository ยท Report an issue

โš ๏ธ **GitHub.com Fallback** โš ๏ธ