Ultraplan โ Planning in the Cloud
Ultraplan takes planning you start in the CLI, writes the plan in the cloud, lets you review it in the browser, and then executes it either in the cloud or locally. Your terminal isn't tied up during planning, so you can work on something else.
Ultraplan is a research preview feature that works on Claude Code v2.1.91 or later. Check your version with claude --version first. Behavior and features may change.
How It Differs from Plan Modeโ
| Plan mode | Ultraplan | |
|---|---|---|
| Where planning happens | Local terminal | Cloud (Claude Code on the web) |
| How you review | Text responses in the terminal | Inline comments, emoji, section-by-section edits in the browser |
| Terminal occupied | Terminal unusable while planning | Terminal usable while planning |
| Execution options | Local only | Run in the cloud (โ PR) or send to local |
Requirementsโ
- Claude Code v2.1.91 or later
- A Claude Code on the web account
- A GitHub repository (the cloud session clones the repo)
- If Remote Control is active, it's disabled automatically (they can't be used at the same time)
- Third-party providers not supported โ if you use Claude through Amazon Bedrock, Google Cloud Vertex AI, or Microsoft Foundry, you can't use Ultraplan (it's Anthropic cloud infrastructure only)
How to Use Itโ
Getting Startedโ
There are three ways to start:
# 1. The /ultraplan command
/ultraplan Migrate the auth service to JWT
# 2. Include the ultraplan keyword in your prompt
Plan the switch of auth to JWT using ultraplan
# 3. Switch from the options shown after a local Plan completes
# โ Choose "No, refine with Ultraplan on Claude Code on the web"
Checking Statusโ
While planning runs in the cloud, the terminal shows the status:
| Status | Meaning |
|---|---|
โ ultraplan | Claude is analyzing the codebase and writing the plan |
โ ultraplan needs your input | A question in the browser needs an answer |
โ ultraplan ready | The plan is done and ready for review in the browser |
Selecting the ultraplan entry in /tasks shows the session link, agent activity, and a stop option.
Reviewing in the Browserโ
Once the status reaches โ ultraplan ready, open the session link to review the plan:
- Inline comments: Highlight a specific passage and leave a comment
- Emoji reactions: Mark approval or concern on a section
- Outline sidebar: Jump quickly between sections
When you leave a comment, Claude proposes a revision. Repeat until you're satisfied.
Choosing How to Executeโ
Once the plan is settled, pick one of two options in the browser:
Run in the cloud: "Approve Claude's plan and start coding" โ implementation happens in the same cloud session โ a PR is created
Send to local: "Approve plan and teleport back to terminal" โ the plan is sent to your terminal. Three options:
- Implement here: Inject the plan into the current conversation and continue
- Start new session: Start a new session with just the plan
- Cancel: Save it to a file for later
Usage Scenariosโ
Large Refactorsโ
/ultraplan Plan splitting the payments module into microservices
You can keep working in the terminal while reviewing the architecture plan section by section in the browser.
PR-Based Workโ
Running the plan in the cloud creates a PR automatically, connecting directly into your code review workflow.
Limitationsโ
| Limitation | Description |
|---|---|
| GitHub required | The cloud session clones a GitHub repo |
| Can't be used with Remote Control | Starting ultraplan disables Remote Control |
| Network required | It's a cloud session, so no offline use |
Real usage insights, delivered free. Subscribe โ