Permission Profiles

A profile decides which tool effects run automatically and which prompt you first. Cycle them anytime with S-Tab; your choice persists across sessions.

ProfilePure readsWrites / editsShell / buildNetwork
Writeautoautoautoauto
Ask (default)autopromptpromptprompt
Minimalautopromptpromptprompt

Ask (default)

Read-only tools run automatically; writes, shell calls, and network calls each prompt before running. The safe default for an unfamiliar repo.

Write (autonomous)

Everything runs without prompting. Use this when you trust the task and want agentty to move fast — paired with the sandbox and workspace boundary, an autonomous run still can't escape your project directory or read your secrets.

Minimal

The most conservative profile — only pure tools (reads, search, definition lookup) run automatically; everything else prompts, including operations Ask might batch.

TipThe permission policy is a compile-time constexpr matrix guarded by static_asserts. Changing a policy cell breaks the build, not a test nobody runs — the safety guarantee is structural.