Agents
Cursor Agents Window: Multi-Agent UI, Cloud Runs & PR Handoff
The Agents Window is Cursor's agent-first interface for running many agents at once. From one window you run parallel cloud agents across workspaces, review diffs and pull requests, hand work off with /in-cloud and /autopilot, and isolate tasks in worktrees. Open it with ⌘⇧P → Open Agents Window, and return to the editor with Open IDE.

On this page
- How do I switch between Agents Window and the editor?
- What are the panes in the Agents Window?
- How do I commit to a different branch from the review pane?
- Can the Agents Window drive IDEs Cursor can't natively run in?
- What can I do only in the Agents Window?
- Foreground or background: which agent runs the task?
- When should I stay in the classic editor instead?
- How do Enterprise admins control Agents Window access?
How do I switch between Agents Window and the editor?
You switch between the two from the Command Palette, and you can switch back at any time.
- Open the Agents Window
- Command Palette (⌘⇧P) → Open Agents WindowCursor's surface listing your agent runs; open a run to read its diff and search transcripts from the command palette. Press Enter for the full definition., or the Agents Window button at the top right of the editor.
- Go back to the editor
- Command Palette → Open IDE, or the small arrow at the top right.
- Start from scratch
- File → New Agents WindowCursor's surface listing your agent runs; open a run to read its diff and search transcripts from the command palette. Press Enter for the full definition. opens a fresh agent-first instance.
- Peek at a file
- ⌘P searches files and ⌘⇧F searches all files, without leaving the Agents WindowCursor's surface listing your agent runs; open a run to read its diff and search transcripts from the command palette. Press Enter for the full definition..
Cursor's classic editor is a fork of VS Code. For Cursor 3An older release label for Cursor's multi-agent interface; current product guidance calls the active surface the Agents Window. Press Enter for the full definition., the company went a step further and built this interface from scratch, centered around agents. One Cursor field engineer described the shift as deliberate: the company has moved away from the file-tree-and-debugger view and put the agent at the center. That matters most for designers, PMs and other non-engineers who never wanted the IDE surface in the first place.
Over the past couple months we've seen a departure from this type of view and we've seen more of a focus on agents.
This is covered hands-on in Agent Mode Foundations — 6 short Units, free to read.
Rather do it than read about it? Run 11 interactive Cursor walkthroughs in a simulated editor. Free, no account needed.
What are the panes in the Agents Window?
The layout has three regions. You start agents from the prompt window in the center. The agent pane at the top left holds several workspaces or repositories in one instance and runs agents across all of them, and each workspace keeps its own index. The panel on the right is for inspecting the work, the way you would in an IDE.
- File browser
- Navigate the workspace like the classic explorer.
- Sandbox terminal
- A terminal per agent, so each run's shell stays isolated.
- Cursor browser
- Drive and screenshot a running app for verification.
- Review pane
- Inspect every edit an agent made before you commit.
Each workspace you open will contain its own indexing. So this kind of allows you to run multiple agents across multiple projects, switch between the progress of them, and see them unfold in real time.
Cloud agents appear here too, and you can start them from the same window. Cursor's docs list remote SSH among the environments the Agents WindowCursor's surface listing your agent runs; open a run to read its diff and search transcripts from the command palette. Press Enter for the full definition. works in. In a Cursor webinar on mobile development, the presenter said SSH in the Agents Window had been updated to be "a little bit more functional for remote development than the IDE". Try it if your target is a remote or embedded platform you reach over SSH.
How do I commit to a different branch from the review pane?
Agents can review their own work in the review pane, and you can branch and commit from the same place. The current branch shows at the top right and on the review tab, which sits at the top left once there are changes. Next to the commit-and-push button is a small arrow.
If you made changes on main but want them on a different branch, click the arrow to the right of commit and push. Cursor creates a new branch and commits there instead.
Can the Agents Window drive IDEs Cursor can't natively run in?
Yes, by running it as a sidecar. In Cursor's webinar on mobile development, the presenter ran the Agents WindowCursor's surface listing your agent runs; open a run to read its diff and search transcripts from the command palette. Press Enter for the full definition. next to Xcode or Android Studio and moved back and forth between them. The work flows in both directions, which is how the Agents Window covers IDEs Cursor can't drive natively.
The approach we're going to take for mobile development is using that agent window as a sidecar to help enhance both iOS and Android IDEs and have the integration flow between the two in a bidirectional way.
The other route is ACPAgent Client Protocol. An open standard that lets any IDE host any coding agent; Cursor uses it to run inside JetBrains/IntelliJ and Android Studio. Press Enter for the full definition. (the Agent Client ProtocolAn open standard that lets any IDE host any coding agent; Cursor uses it to run inside JetBrains/IntelliJ and Android Studio via the Cursor CLI bridge. Press Enter for the full definition.), which runs Cursor's agent inside the other IDE's own chat instead of beside it. Cursor documents ACP for JetBrains IDEs, and the presenter described it as one option for Android Studio. ACP also reaches well beyond JetBrains. The presenter pointed to open-source ACP integration work for Neovim and Emacs, and to Obsidian, where Cursor can act as an agent inside your note editor while you write.
What can I do only in the Agents Window?
Because it is built for running many agents at once, the Agents WindowCursor's surface listing your agent runs; open a run to read its diff and search transcripts from the command palette. Press Enter for the full definition. has features the editor lacks. You need them once agents write most of the code and your job shifts to managing the runs.
That change reaches past engineering. A Cursor support engineer described starting one agent per incoming ticket, such as "how do I log in with SCIMSystem for Cross-domain Identity Management. A standard for automatically creating and removing user accounts when people join or leave. Press Enter for the full definition." or "what does the analytics dashboard show". The engineer reviews the work as it streams in and opens each agent individually, with little context switching. Time is the scarcest resource in support, and this setup lets one person keep up with a steady flow of tickets without waiting on a single agent.
- Multi-workspace
- Manage agents across all your projects from one place.
- Parallel cloud agents
- Run many agents in the cloud, and work with them from your phone, the web, Slack, GitHub or Linear.
- Diffs and PRs
- Review and commit changes and manage pull requests without switching apps.
- Local and cloud handoff
- Move a task to the cloud to keep it running, then pull it back to local to iterate quickly.
- Cloud subagents
/in-cloudhands a task to a cloud subagent and/autopilothands one a pull request. Each runs on its own VM and branch.- Worktrees
- Isolated Git checkouts, so parallel tasks don't overwrite the same files.
The changelog that introduced the pull-request handoff called it /babysit. Cursor's docs now name it /autopilot. The three cloud rows need a plan that includes Cloud AgentsAgents that run in a Cursor-managed virtual machine, check out the repo, do the work and open a pull request, then shut down, with no load on your laptop. Press Enter for the full definition., which start at Premium on The X SubscriptionThe subscription Cursor is sold through: one plan for Grok, Cursor and X, with Free, Plus, Premium, Super and Ultra tiers, per-seat Teams, a weekly included pool for Cursor models shared with Grok, and third-party models billed at API list price from prepaid credit. Press Enter for the full definition..
Foreground or background: which agent runs the task?
AI coding has moved through three eras. Tab predicted your next edit while you typed. Synchronous agents then edited across files while you watched. Now asynchronous cloud runs work toward a goal on their own branch. Day to day, the choice that matters is between the last two: keep a task in the foreground when it needs your judgment, and send it to the background when its output can prove itself.
Interactive widget. Tab through its controls; the result updates in the panel below as you change them.
If the result can be checked through an artifact, the task can run async. If the task is ambiguous, keep it in the foreground.
Foreground is for decisions: the task is ambiguous, it needs steering, you want quick front-end feedback, you are watching it live, or it touches something security-sensitive. You see and control every step. Background is for execution against a clear goal with acceptance criteria, where the output is artifact-verifiable: an image, a recording, a log or a diff you can read after the fact.
Before you send a task to the background, name the artifact you will review when it finishes, such as a test run, a screenshot, a log or a diff. If you can't name one, keep the task in the foreground where you can step in.
- Task
- Explore an unfamiliar API or spike a feature
- Where it runs
- Foreground
- Why
- The path is unknown, so you steer as the agent learns its shape.
- Task
- Live-observed UI tweaks
- Where it runs
- Foreground
- Why
- You watch the rendered result and correct it mid-flight.
- Task
- Refactor with a passing test suite
- Where it runs
- Background
- Why
- The diff plus a green test run is the artifact you review.
- Task
- Branch migration across many files
- Where it runs
- Background
- Why
- A clear goal and the resulting diff make it verifiable async.
- Task
- Database migration with a checked plan
- Where it runs
- Background
- Why
- The acceptance criteria are explicit, and you read the log and diff.
| Task | Where it runs | Why |
|---|---|---|
| Explore an unfamiliar API or spike a feature | Foreground | The path is unknown, so you steer as the agent learns its shape. |
| Live-observed UI tweaks | Foreground | You watch the rendered result and correct it mid-flight. |
| Refactor with a passing test suite | Background | The diff plus a green test run is the artifact you review. |
| Branch migration across many files | Background | A clear goal and the resulting diff make it verifiable async. |
| Database migration with a checked plan | Background | The acceptance criteria are explicit, and you read the log and diff. |
Same agent, different home: ambiguity keeps a task local, and a checkable artifact sends it to the cloud.
In a July 30, 2026 post, Cursor wrote that cloud agents write more than half of the pull requests merged to its monorepo, up from roughly one in ten the previous December. Its February 2026 post had put the share of PRs it merges internally at 35%, and in a webinar a Cursor engineer put it at almost 40%. These are vendor figures about Cursor's own work, so read them as dogfooding, not as an industry benchmark. Even scoped that way, they show that asynchronous runs against clear goals already carry a real share of shipped work.
When should I stay in the classic editor instead?
Stay in the editor when you want VS Code extensions, flexible split panes and manual navigation across many open files. Use the Agents WindowCursor's surface listing your agent runs; open a run to read its diff and search transcripts from the command palette. Press Enter for the full definition. when agents write most of the code and your work is starting and reviewing parallel runs. Cursor's docs say the Agents Window pulls you up to a higher level of abstraction, and that Cursor will keep supporting and improving both.
The choice isn't permanent. You can switch at any time or keep both open. For a quick look at one file you don't need to switch at all, because ⌘P and ⌘⇧F work inside the Agents WindowCursor's surface listing your agent runs; open a run to read its diff and search transcripts from the command palette. Press Enter for the full definition..
How do Enterprise admins control Agents Window access?
Agents WindowCursor's surface listing your agent runs; open a run to read its diff and search transcripts from the command palette. Press Enter for the full definition. became generally available with Cursor 3An older release label for Cursor's multi-agent interface; current product guidance calls the active surface the Agents Window. Press Enter for the full definition., released on April 2, 2026. For the two weeks after launch, Enterprise admins could give access to their whole team or to specific users from Team settings. After that rollout period, Cursor's docs say all users have access by default.
Cursor's Agents WindowCursor's surface listing your agent runs; open a run to read its diff and search transcripts from the command palette. Press Enter for the full definition. docs don't describe a control for limiting access after the rollout ended. If your organization needs one, confirm what your admin dashboard offers before you plan around it.
Frequently asked questions
Can I run local and cloud agents in the same window?
Yes. The Agents Window is built for handoff: move a task to the cloud to keep it running, then pull it back to local to iterate quickly.
Do worktrees replace Git branches?
No. Worktrees are separate checkouts that keep agents isolated. You still merge through your normal Git and pull-request flow when the task is done.
Is Design Mode available in Agents Window?
Yes. Design Mode runs in the Agents Window browser, and you toggle it with ⌘⇧D. See the Design Mode guide for visual editing.
Sources & last verified
- Cursor - Agents Window
- Cursor - Subagents
- Cursor - Worktrees
- Cursor Blog - Meet the new Cursor
- Cursor Blog - The third era of AI software development
- Cursor Blog - How we set up our cloud agent environment
- Cursor - JetBrains
- Cursor - Models and pricing
Cursor ships frequently. Last updated October 28, 2026.