Home › Sources › Plan in the cloud with ultraplan

Plan in the cloud with ultraplan

Tags

official-docs claude-code-cli

Content

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt Use this file to discover all available pages before exploring further.

Plan in the cloud with ultraplan

Start a plan from your CLI, draft it on Claude Code on the web, then execute it remotely or back in your terminal

Ultraplan is in research preview and requires Claude Code v2.1.91 or later. Behavior and capabilities may change based on feedback.

Ultraplan hands a planning task from your local CLI to a Claude Code on the web session running in plan mode. Claude drafts the plan in the cloud while you keep working in your terminal. When the plan is ready, you open it in your browser to comment on specific sections, ask for revisions, and choose where to execute it.

This is useful when you want a richer review surface than the terminal offers:

Ultraplan requires a Claude Code on the web account and a GitHub repository. Because it runs on Anthropic's cloud infrastructure, it is not available when using Amazon Bedrock, Google Cloud Vertex AI, or Microsoft Foundry. The cloud session runs in your account's default cloud environment. If you don't have a cloud environment yet, ultraplan creates one automatically when it first launches.

Launch ultraplan from the CLI

From your local CLI session, you can launch ultraplan in three ways:

For example, to plan a service migration with the command:

/ultraplan migrate the auth service from sessions to JWTs

The command and keyword paths open a confirmation dialog before launching. The local plan path skips this dialog because that selection already serves as confirmation. If Remote Control is active, it disconnects when ultraplan starts because both features occupy the claude.ai/code interface and only one can be connected at a time.

After the cloud session launches, your CLI's prompt input shows a status indicator while the remote session works:

Status Meaning
◇ ultraplan Claude is researching your codebase and drafting the plan
◇ ultraplan needs your input Claude has a clarifying question; open the session link to respond
◆ ultraplan ready The plan is ready to review in your browser

Run /tasks and select the ultraplan entry to open a detail view with the session link, agent activity, and a Stop ultraplan action. Stopping archives the cloud session and clears the indicator; nothing is saved to your terminal.

Review and revise the plan in your browser

When the status changes to ◆ ultraplan ready, open the session link to view the plan on claude.ai. The plan appears in a dedicated review view:

When you ask Claude to address your comments, it revises the plan and presents an updated draft. You can iterate as many times as needed before choosing where to execute.

Choose where to execute

When the plan looks right, you choose from the browser whether Claude implements it in the same cloud session or sends it back to your waiting terminal.

Execute on the web

Select Approve Claude's plan and start coding in your browser to have Claude implement it in the same Claude Code on the web session. Your terminal shows a confirmation, the status indicator clears, and the work continues in the cloud. When the implementation finishes, review the diff and create a pull request from the web interface.

Send the plan back to your terminal

Select Approve plan and teleport back to terminal in your browser to implement the plan locally with full access to your environment. This option appears when the session was launched from your CLI and the terminal is still polling. The web session is archived so it doesn't continue working in parallel.

Your terminal shows the plan in a dialog titled Ultraplan approved with three options:

If you start a new session, Claude prints a claude --resume command at the top so you can return to your previous conversation later.