DocsWorking with Alran
Plan Mode and permissions
Look before it builds, and decide what it may run.
How do I see the plan before Alran builds?
Press Shift+Tab (or /plan on) and Alran only investigates and plans: it reads the project and writes a plan, but changes nothing. Read the plan, adjust it in the conversation, then switch Plan Mode off and let it build.
| Command | What it does |
|---|---|
/plan on | Plan Mode on |
/plan off | Back to the default mode |
/plan status | Show the current mode |
/plan view | Open the latest plan |
Permission modes
The permission mode decides which steps need your OK. Switch with Alt+M or /permission.
| Mode | What happens |
|---|---|
| Ask | Every step with an effect asks first. |
| Auto | Routine steps in your workspace run; steps with effects outside wait for your OK. |
| Full Access | Everything runs without asking. Use it in a sandbox or a throwaway environment. |
Approving a step
A step that needs your OK shows a card with what it wants to do. Answer there, or type:
| Command | What it does |
|---|---|
/allow | Allow this step once |
/always | Always allow this kind of step |
/deny | Deny it |
/permissions | Show every pending request |
/decision | Reopen the pending action panel |
In scripts
alran exec has no one to ask, so it takes a policy instead: --permission smart (the default), full or off. See Headless and CI.
Permissions and the sandbox reduce risk, they don't replace review. Check untrusted plugins, MCP servers and shell commands before you allow them.
Common questions
How do I see the plan before Alran builds?
Press Shift+Tab or use the command /plan on and Alran only investigates and plans: it reads the project and writes a plan, but changes nothing. Read the plan, adjust it in the conversation, then switch Plan Mode off and let it build.
Which permission mode should I use?
Ask asks before every step with an effect, Auto runs routine steps in your workspace and waits for steps with effects outside, and Full Access runs everything without asking. Switch the mode with Alt+M or the command /permission. In scripts, alran exec takes a policy instead: --permission smart is the default, plus full or off.
How do I approve a step that needs my OK?
Answer on the card that shows what the step wants to do, or use /allow for this step once, /always for this kind of step and /deny to refuse it. The command /permissions shows every pending request.