# Claude Code Ultraplan Hands a planning task from the local CLI to a [[Claude Code Web]] session running in plan mode. Claude drafts the plan in the cloud while the terminal stays free. When the plan is ready, open it in the browser to comment on sections, ask for revisions, and choose where to execute. Research preview, requires v2.1.91+. ## Why Use It - **Targeted feedback**: comment on individual sections instead of replying to the whole plan - **Hands-off drafting**: plan generates remotely, terminal stays free for other work - **Flexible execution**: approve to run on the web (opens a PR), or send back to terminal Requires a Claude Code Web account and a GitHub repository. Not available with Bedrock, Vertex AI, or Foundry. The cloud session runs in your account's default cloud environment; if you don't have one yet, ultraplan creates it automatically on first launch. ## Launching Three ways to launch from a local CLI session: - **Command**: `/ultraplan migrate the auth service from sessions to JWTs` - **Keyword**: include the word `ultraplan` anywhere in a normal prompt - **From a local plan**: when Claude finishes a local plan and shows the approval dialog, choose "No, refine with Ultraplan on Claude Code on the web" Command and keyword paths show a confirmation dialog. The local plan path skips it. If Remote Control is active, it disconnects (both occupy the claude.ai/code interface). ## Status Indicators After launch, the CLI prompt shows: | Status | Meaning | |--------|---------| | `◇ ultraplan` | Claude is researching the codebase and drafting the plan | | `◇ ultraplan needs your input` | Claude has a clarifying question; open the session link | | `◆ ultraplan ready` | Plan is ready to review in browser | Run `/tasks` and select the ultraplan entry to see the session link, agent activity, and a "Stop ultraplan" action. Stopping archives the cloud session and clears the indicator — nothing is saved to the terminal. ## Review in Browser When ready, the plan appears in a dedicated review view: - **Inline comments**: highlight any passage and leave a comment - **Emoji reactions**: signal approval or concern without a full comment - **Outline sidebar**: jump between sections - Iterate as many times as needed before choosing where to execute ## Execution Options ### Execute on the web Select "Approve Claude's plan and start coding" in the browser. Claude implements in the same cloud session. Review the diff and create a PR from the web interface. ### Send back to terminal Select "Approve plan and teleport back to terminal". Only available when the session was launched from a local CLI and the terminal is still polling. The web session is archived so it doesn't keep working in parallel. Terminal shows an "Ultraplan approved" dialog with three options: - **Implement here**: inject the plan into the current conversation - **Start new session**: clear conversation, begin fresh with only the plan. Prints a `claude --resume` command for the previous conversation - **Cancel**: save the plan to a file without executing; Claude prints the file path ## References - https://code.claude.com/docs/en/ultraplan ## Related - [[Claude Code]] - [[Claude Code Web]] - [[Claude Code Remote Control]]