← All help topics

Permission modes

The permission mode decides what the AI may do on its own. Choose it at the top of the Permissions page.

ModeWhat happens
TrustedNever asks. Everything runs, except what your rules block.
Balanced (recommended)Asks before deleting, overwriting or running terminal commands. Everything else runs.
StrictAsks before anything that changes something. Reading is always fine.
Read-onlyBlocks anything that changes something. The AI can only look.

Tools that only read always run, in every mode.

How a tool's kind is decided

Every tool says how much it can change:

  • Read-only: it only looks, like reading a file or listing your calendar.
  • Makes changes: it creates or changes things, but doesn't delete or overwrite them, like creating a note.
  • Can delete or overwrite: it removes or replaces things, like deleting a file or running a terminal command.

The Tools page shows this as a tag on each tool. Some tools decide per call: writing a new file counts as a change, but overwriting an existing one counts as overwriting.

What overrides the mode

The mode is the default. These come first, in order:

  1. Hard blocks. Some calls are always refused, like a terminal command on the deny list (such as sudo).
  2. Your rules on the Permissions page, and the per-tool choices on the Tools page.
  3. A tool's own setting, for tools whose pack says "always ask".

Tip: Balanced is a good start. If one tool asks too often, set it to Always run on the Tools page instead of switching everything to Trusted.

See also Approvals and Rules.