Skip to content

Permissions modes

igardev edited this page Nov 13, 2026 · 2 revisions

Permissions Modes

Overview

Permissions modes control whether and how the agent's tool calls are executed. There are four modes:

  • AllowAll: All tool calls are allowed.
  • AutoAskIfUnsure: The LLM judges whether a command is safe and asks the user when unsure.
  • AutoDenyIfUnsure: The LLM judges whether a command is safe and denies the call when unsure.
  • Ask: The user is asked for confirmation.

How It Works

The default mode is Ask. You can change the mode in the following ways:

  • Change the tools_permissions_mode setting.
  • In the agent chat view, click the permissions mode button at the bottom-left, next to the agent selector button.
  • From the Telegram bot (see the Telegram section) with the commands /permissions (lists the modes) and /setpermission (changes the mode).

Settings

tools_permissions_mode:

  • AllowAll: Allows all commands to be executed by the AI. Also known as YOLO mode. Use this mode with caution.
  • AutoAskIfUnsure: Obviously safe commands (read-only, inside the project or the auto memory folder) run without asking. Obviously dangerous commands (privilege escalation, recursive/forced deletes, credentials and profile paths, system directories, downloads piped into a shell) are denied. Only commands that fall between these categories are judged by the LLM: allow if safe, deny if unsafe, and ask the user if unsure. Uses the chat model (if available) or the tools model.
  • AutoDenyIfUnsure: Obviously safe commands (read-only, inside the project or the auto memory folder) run without asking. Obviously dangerous commands (privilege escalation, recursive/forced deletes, credentials and profile paths, system directories, downloads piped into a shell) are denied. Only commands that fall between these categories are judged by the LLM; if it is unsure or cannot answer, the command is denied. Uses the chat model (if available) or the tools model.
  • Ask (default): The user is asked for permission. In this mode, some commands can be executed automatically without asking if any of the following settings are set to true: tool_permit_some_terminal_commands, tool_permit_file_changes, tool_permit_file_deletes.

Clone this wiki locally