> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# Approvals

> What the agent asks before doing, how you answer, and where the question shows.

## Modes

| Mode | What the agent does |
| - | - |
| `read-only` | Reads. It does not edit files or run commands. |
| `ask` | Asks before it edits, runs commands or changes anything. |
| `yolo` | Does them without asking. |

Even in `yolo` it always asks before sending something to someone else (a message), before changing an account in another app, and when a plugin asks you to decide.

The mode is yours, the same in every folder. Change it in **Manage → Permissions**, from the status bar, or in the terminal with **Shift+Tab** or `/permissions`.

## Answering

* **Allow once** (`Y`)
* **Always allow** (`A`): this tool, without asking again in this conversation
* **Deny** (`N`), or **Deny with a reason**: the agent reads the reason and tries again another way

## Where it shows

> [card] App
>
> A card in the conversation, and a mark on the conversation in the sidebar.

> [card] Phone
>
> An **Approval needed** notification; press it for Allow and Deny.

> [card] Terminal
>
> Choices: Allow once, Always allow, Deny, Deny and say why.

Answer in any one of them; the others follow.

## Rules

`approvalRules` in a config file allows, denies or always asks for a tool's calls. The first rule that matches decides; a project's rules come before yours.

```json theme={null}
{
  "version": 1,
  "approvalRules": [
    { "tool": "run_process", "action": "deny", "when": { "program": "rm" } },
    { "tool": "run_process", "action": "allow", "when": { "program": "bun", "args": ["test"] } },
    { "tool": "edit_files", "action": "allow", "when": { "path": "src/" } }
  ]
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.