DEEN

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.

CommandWhat it does
/plan onPlan Mode on
/plan offBack to the default mode
/plan statusShow the current mode
/plan viewOpen the latest plan

Permission modes

The permission mode decides which steps need your OK. Switch with Alt+M or /permission.

ModeWhat happens
AskEvery step with an effect asks first.
AutoRoutine steps in your workspace run; steps with effects outside wait for your OK.
Full AccessEverything 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:

CommandWhat it does
/allowAllow this step once
/alwaysAlways allow this kind of step
/denyDeny it
/permissionsShow every pending request
/decisionReopen 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.