Permission Modes

Syntic Code never runs a command or edits a file silently unless you have told it that it may. Permission modes are how you set that boundary. They control which actions Amara can take on its own and which require your explicit approval, letting you trade speed for oversight depending on how much you trust the current task.

The available modes

• Default — Amara proposes each file edit and each command, and waits for your approval before acting. You see exactly what it wants to do and can accept, reject, or edit the plan. This is the safest mode and a sensible starting point.
• Auto-accept — Amara carries out edits and previously approved kinds of commands without pausing, so it can work through multi-step tasks quickly. You still see everything it does in the transcript and can interrupt at any time.
• Plan — Amara analyzes the task and writes out a step-by-step plan without touching any files or running any commands. Nothing changes on disk until you review the plan and let it proceed. This is ideal for large or risky changes.
• Dangerously-skip — Amara skips all approval prompts, including for commands that can modify your system. As the name warns, use this only in disposable or sandboxed environments where a mistake cannot cause harm.

How approvals work

In default mode, each proposed action appears with enough detail to judge it: the file and diff for an edit, or the full command line for a shell command. You approve or decline per action. Syntic Code remembers approvals within a session, so repeating a similar command may not prompt again. Read-only operations such as reading a file or searching the repository generally do not require approval in any mode.

Choosing and switching modes

Pick a mode based on the blast radius of the work. Use plan mode to think through a refactor, default mode for routine changes you want to watch, and auto-accept when you are confident and want to move fast. You can set a mode when you launch syntic and change it during a session. When in doubt, choose the more cautious mode — you can always loosen it once you trust what Amara is doing.