Build / Plan toggle

The Build / Plan toggle switches the Riff agent between executing changes and planning them first without making any edits.

The Build / Plan toggle is in the Riff agent chat input. It controls whether the Riff agent executes changes or plans them first.

The two modes

Mode	What the Riff agent does
Build (default)	Writes code, makes changes, installs packages, updates configuration — it acts
Plan	Describes exactly what it would do and why, without making any changes

Plan mode is shown in orange in the chat input.

When to use Plan

• Before a significant change — ask the Riff agent to plan a new feature before it builds it. Review the plan, refine it in conversation, then switch to Build.

• When something is going wrong — switch to Plan to understand what the agent intends to do next before it does it.

• When you want to learn — Plan mode explains the Riff agent's reasoning, which helps you understand what is being built and why.

When to use Build

Build is the default for a reason — most of the time you want the Riff agent to act, not just describe. Use Build whenever you are ready for changes to happen.

Important

The Build / Plan toggle only affects what the Riff agent does in response to your message. It does not affect your agent's live behaviour or any deployed version. It is a building tool, not a runtime control.