Approve a plan
Read an agent's plan, approve it, request changes or ask a question before any code is written.
On this page
Most workflows stop after planning so a person can check the approach before an agent writes code. The plan arrives in your Inbox as Approve the plan. Approving costs nothing extra; it lets the run continue.
What a plan contains
A plan usually has four parts:
- Problem: what the agent understood from the issue.
- Approach: the numbered changes it will make, such as a migration, a code change and tests.
- Risks: anything that could go wrong, for example a lock on a busy table.
- Out of scope: related work it won’t do in this run.
You can read the full plan in the run’s Plan tab, next to the conversation where the agent explains its reasoning.
Approve the plan
- Open Inbox and select the ask titled Approve the plan. Or press G then I, and move between asks with J and K.
- Read the numbered steps and check they match what you expect. Open the run with ↵ if you want the full plan, linked issues or the agent’s notes.
- Select Approve plan, or press ⌘ ↵. The agent starts implementing straight away, in its own branch.
Changed your mind straight after approving? Press Z in the Inbox to undo your last decision while the agent hasn’t started.
Request changes
If the approach is wrong or incomplete, don’t approve it. Ask for a better plan instead.
- Select Request changes on the ask or in the run.
- Write what should change, in plain words. For example: “Make the backfill a dry run first. Finance reconciles on Mondays.”
- Send it. The agent revises the plan and asks you again before writing any code.
To ask something without changing the plan, type in the run’s conversation instead. The agent answers there and keeps the ask open.
Hand it to someone else
Not the right person to judge? Select Hand off and choose Hand to teammate… to move the ask to a colleague, with an optional note about what to look at first. The ask leaves your Inbox and lands in theirs.
Auto-approve after a countdown
Admins can turn on Auto-approve plans after a countdown in Settings → Action approvals. When it’s on, the ask shows “auto-approves in 28m” (or whatever time is set), and plans nobody answers go ahead after that. It never applies to factories in Ask for everything mode.
If something goes wrong
- You don’t see the ask. It may have been handed to someone else, or a teammate approved it. Check the run’s conversation for who acted.
- The plan keeps coming back wrong. Add the missing context to the project’s Context, or add a rule to the agent’s guidance in Settings → Guidance & memory.
Developers: plan approval is a User approval gate on a workflow step. See Gates and failure handling.