Understand permission modes

Axiomate can read files, edit code, and run commands. Permission modes control when it asks before using tools.

Switch modes

In the chat input, press Shift+Tab to cycle permission modes. On some Windows terminals where Shift+Tab is unreliable, the default fallback is Meta+M.

The common cycle covers Default, Accept edits, and Plan Mode.

Common modes

Default

Standard behavior. Axiomate prompts before sensitive operations.

Accept edits

File edits are auto-accepted while more sensitive operations still stay controlled.

Plan Mode

Axiomate explores and plans before implementation. Use it for complex or ambiguous work.

Bypass Permissions

Skips permission checks. Use only when you trust the project, task, and session.

Set the startup default

In Settings or /config, change Default permission mode.

The config field is:

{
  "permissions": {
    "defaultMode": "default"
  }
}

Supported values:

default
plan
acceptEdits
bypassPermissions

You can also set it for one startup:

axiomate --permission-mode acceptEdits