Skip to main content
Plan Mode allows you to understand and scope work before building. When enabled, the coding agent traverses the codebase, proposes an implementation and step-by-step plan, and asks you clarifying questions if needed.
Plan Mode

​
How to Use

  1. Start your message with /plan (on the dashboard, you can click to toggle!)
  2. Agent returns the plan. If using from GitHub or Linear, the agent will provide a link for you to review the plan.
  3. Answer potential clarifying questions, or tell it to go ahead!
Example: 
/plan add usage tracking to the billing endpoint

​
Viewing Plans in the Canvas Panel

Plans show up in the Canvas panel in the lower half of the provenance pane on the right side of the workspace. Each item gets a type pill: Plan for markdown, Page for HTML, Image/Video/Audio for media. Click any item to open it in the main viewport, the same way clicking a file in the diff list opens the diff. The Canvas reads from ~/.replicas/canvas/ on the workspace VM, so anything the agent drops in there is one click away.

​
Copy and Download Plan Contents

When viewing a plan in the main viewport, the header has a Copy button (copies the markdown to your clipboard) and a Download button (saves it as a .md file).

​
Quote-Reply From the Plan Viewer

When reviewing a plan, select any chunk of text (for example, a clarifying question at the end of the plan) to get a floating Reply button. Clicking it adds a comment card to the chat composer, similar to commenting in Google Docs. Each card holds the quoted text and its own reply box, so you can leave multiple comments on different sections of the plan and reply to each one independently. Hit Send to ship every quote and reply in a single message; the chat tab will render them as structured blocks so the agent (and you) can see exactly what each reply is responding to.