Guide
Cursor Cloud Agents Guide
A Cursor cloud agent runs a task in an isolated VM that Cursor manages. It checks out your repo, does the work and opens a pull request, then the VM is torn down. Send work you can verify from its artifacts, such as screenshots and recordings, to the cloud. Keep fuzzier work that needs your judgment local.

On this page
- What changed in the June 2026 Cloud Agents update?
- How should a team use cloud agents?
- What should a team watch out for?
- How do artifacts, grind mode and self-hosting work?
- How does self-hosted Cloud Run fit?
- How should you picture a cloud agent, and how do you start one?
- Can I drive a cloud agent from Slack?
- Can a webhook start a cloud agent with no human at the keyboard?
- What does a cloud agent hand back besides a diff?
What changed in the June 2026 Cloud Agents update?
Cursor's June 2026 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. update added guided setup for cloud environments, reusable snapshots and .cursor/environment.json. It also added /in-cloud subagents, /babysit (now /autopilot) for supervising pull requests and a more reliable handoff between local and cloud.
- Release fact
- Cloud setup
- What to know
- Cursor can help set up a cloud development environment in less than 10 minutes.
- Release fact
- Reusable snapshots
- What to know
- You can capture a working environment so later cloud agents boot faster and can run your software.
- Release fact
- /in-cloud
- What to know
- A cloud subagent runs the next task in its own VM and branch.
- Release fact
- /babysit
- What to know
- A cloud agent can keep iterating on a PR until it is closer to merge-ready. As of October 28, 2026, Cursor's docs call this
/autopilot.
- Release fact
- Handoff
- What to know
- Work can move from local to cloud and back while keeping its branch and verification context.
| Release fact | What to know |
|---|---|
| Cloud setup | Cursor can help set up a cloud development environment in less than 10 minutes. |
| Reusable snapshots | You can capture a working environment so later cloud agents boot faster and can run your software. |
| /in-cloud | A cloud subagent runs the next task in its own VM and branch. |
| /babysit | A cloud agent can keep iterating on a PR until it is closer to merge-ready. As of October 28, 2026, Cursor's docs call this /autopilot. |
| Handoff | Work can move from local to cloud and back while keeping its branch and verification context. |
As of October 28, 2026, unless a row gives a later date. The sources are listed at the end of this page.
Check yourself · one question
Which dependency task is ready for a Cloud Agent?
From the Lesson Choose local or cloud — about 2 minutes, free to read.
Rather do it than read about it? Run 11 interactive Cursor walkthroughs in a simulated editor. Free, no account needed.
How should a team use cloud agents?
Cursor's release notes and announcements say what changed. They don't say how a team should act on it. The steps below are our suggested order, and the next section lists what to watch out for along the way.
- 1Use local Agent or Plan Mode for ambiguous work that needs close supervision.
- 2Set up a cloud environment with install, start and verification commands before you delegate long work.
- 3Launch
/in-cloudonly for tasks with separate branch boundaries and low conflict risk. - 4Pull the result back locally and rerun the checks a human reviewer would trust.
What should a team watch out for?
Each item below is either a fact about the release, such as its beta status or plan access, or our advice for using it safely. Plan around each one, and recheck the facts when Cursor ships an update.
- Don't send work to the cloud until its environment can install, start and test the repo.
- Give parallel agents separate branches, and review one output at a time.
- Keep sensitive or high-blast-radius work local until the data flow and secret boundary are approved.
- Cloud agents need a plan that includes them: Premium and higher, Teams, Enterprise or a legacy paid plan. Free and Plus don't include them.
How do artifacts, grind mode and self-hosting work?
A cloud agent's VM has its own desktop and terminal, and one run can check out several repos in a multi-repo environment. It uses none of your laptop's RAM or disk, and Cursor's docs say you can run as many as you want in parallel, even with your computer offline.
Artifacts: proof of work
The agent can drive its own virtual desktop, so it can check its work the way a person would. It makes a change, opens a browser, tests the change, records video and screenshots, and fixes console errors it finds. When it finishes, it returns the walk-through video with screenshots, type-check and test results, and it can upload the video to the PR.
If a task's output is artifact-verifiable, run it in the background on a cloud agent. The artifact is how you trust the result.
If the work is fuzzier and needs your judgment along the way, keep it local, where you can watch it.
Grind mode
In one Cursor webinar, a presenter showed Grind until done, a toggle that lets a cloud agent work on its own for hours on the longest jobs, such as big migrations or building something from scratch. Cursor's current cloud agent docs don't describe it, so check before you plan around it. Most tasks don't need it, because turning on cloud and asking for the feature already works well.
A self-hosted cloud agent runs its tools on a worker inside your network, so it can reach on-prem source control and internal MCPModel Context Protocol. A standard that lets an AI agent pull in context from outside the repo, like Jira tickets or internal docs. Press Enter for the full definition. servers.
Cursor still runs the agent loop and inference, and inference calls external model providers the same way the desktop app does. "Self-hosted" describes where the tools run, not where the model runs.
How does self-hosted Cloud Run fit?
Cursor's Cloud Run worker-pool guide was a reference setup for Self-Hosted 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. on Google Cloud. It described a deployment pattern, not a second product: worker containers and build artifacts run in your own cloud and connect back to Cursor's fleet management API.
As of October 28, 2026, Cursor's docs index no longer lists that guide, and its address opens the general Team Pools page. The table shows what the guide described, with the prerequisites brought up to date from the Team Pools page.
- Piece
- Cursor worker pool
- What Cursor documented
- A Cloud Run Worker Pool runs containers that start the
agentCLI as pool workers and hold outbound HTTPS connections to Cursor.
- Piece
- Autoscaler pool
- What Cursor documented
- A second single-instance Worker Pool polls Cursor's private-workers summary API and resizes the worker pool through the Cloud Run Admin API.
- Piece
- Prerequisites
- What Cursor documented
- Google Cloud billing,
gcloud, Cloud Run, Artifact Registry, Cloud Build and Secret Manager. Team Pools also needs a Cursor Enterprise plan, self-hosted settings from a team admin and a service account API key. Team API keys can't start pool workers.
| Piece | What Cursor documented |
|---|---|
| Cursor worker pool | A Cloud Run Worker Pool runs containers that start the agent CLI as pool workers and hold outbound HTTPS connections to Cursor. |
| Autoscaler pool | A second single-instance Worker Pool polls Cursor's private-workers summary API and resizes the worker pool through the Cloud Run Admin API. |
| Prerequisites | Google Cloud billing, gcloud, Cloud Run, Artifact Registry, Cloud Build and Secret Manager. Team Pools also needs a Cursor Enterprise plan, self-hosted settings from a team admin and a service account API key. Team API keys can't start pool workers. |
Check the Team Pools page for current requirements, then adapt images, secrets and autoscaling to your infrastructure.
How should you picture a cloud agent, and how do you start one?
Picture a cloud agent as an engineer with a laptop in the cloud. Slack, Linear and the IDE are different ways to direct that engineer. You hand off a task to run in the background and work on something else. For people outside engineering, this is one of the most useful things to set up early.
Once you stop thinking of a cloud run as a job and start thinking of it as a teammate you brief and check back on, the orchestration surfaces make sense.
think about it like as an engineer with a laptop in the cloud is like what a cloud agent is.
You can start a run from any device at cursor.com/agents. One presenter started a run from a phone on the Bay Bridge. Pick a repository and branch, write the instruction, choose a model, link any MCPModel Context Protocol. A standard that lets an AI agent pull in context from outside the repo, like Jira tickets or internal docs. Press Enter for the full definition. servers the task needs (Slack, for example), and start it. The run boots a new VM that mirrors your GitHub repo, the rules and system prompts in the repo, your MCP servers and your skills. Repo-specific slash commandsSaved multi-step prompts you trigger from the / menu, such as run tests, fix CI or open a pull request. Press Enter for the full definition. work inside the cloud run too.
Skills and slash commandsSaved multi-step prompts you trigger from the / menu, such as run tests, fix CI or open a pull request. Press Enter for the full definition. defined in the repo are available in the cloud run, not just locally.
This spins up a brand new VM that has all your information of what your GitHub repository looks like... and it has skill integrated as well. You can actually do slash commandsSaved multi-step prompts you trigger from the / menu, such as run tests, fix CI or open a pull request. Press Enter for the full definition. with that skill.
- Each parallel run works on its own branch.
- The presenter put a typical run at about 10 to 15 minutes at minimum, end to end.
- Link an MCPModel Context Protocol. A standard that lets an AI agent pull in context from outside the repo, like Jira tickets or internal docs. Press Enter for the full definition. server, such as Slack, at launch so the run can reach the tools the task needs.
Can I drive a cloud agent from Slack?
Yes. The Slack integration, one of Cursor's first, starts a cloud agent from the thread where the conversation is already happening, with a person in the loop the whole way. Ask a question in a thread and Cursor launches a cloud agent that answers it. Tell it to implement the change and it starts a VM and makes an attempt. The Slack conversation copies over to cursor.com, where you can follow the diff line by line.
A PM hit a missing-docs gap for an AWS Bedrock integration, dropped it into Slack, and Cursor read the code and drafted the docs. An engineer replied in-thread flagging two things that were wrong; the PM told Cursor over the same thread to fix them; then it shipped. The whole loop was human-reviewed and finished inside the thread.
We had Cursor go in through the Slack thread, update the docs, and then it was shipped. And that... happened within 15 minutes all over Slack.
Can a webhook start a cloud agent with no human at the keyboard?
Yes. One growth engineer wired a webhook to every inbound message to enterprise@. Each one starts a cloud agent that drafts a tailored reply grounded in the docs and the user table, so it can tell an existing customer who wants to expand from a new demo request. The agent drew on Databricks for user data, Slack for release chatter and Notion for internal docs. Front handled the inbox, and a Zap passed the conversation ID to the agent's trigger.
An unattended pipeline needs the credential to be present without a person pasting it. The pattern is to inject the API key into the cloud agent so it runs on its own.
I have this web hook running that's always listening to any calls to enterprise at... I have the API key automatically injected into the cloud agent, so it's able to run this automatically.
What does a cloud agent hand back besides a diff?
A cloud run returns artifacts: screenshots and screen recordings of what it built, so you can judge the behavior without running anything yourself. In one demo, an Opus cloud run was told to build a bot, use a repo skill and "give me a demo". It handed back a video of the bot fighting and winning. You watch the recording, then open the PR and merge it if the behavior is right.
The recording is your evidence. If a task's output is something you can watch and verify, route it async and let the artifact be how you trust it.
It not only provides you a diff file of the PR that it created, it also gives you (internally we call it artifacts) screenshots as well as screen recordings.
In one Cursor talk, a presenter said the team is exploring iOS and Android simulators inside cloud agents, to make mobile testing smoother than today's cross-app MCPModel Context Protocol. A standard that lets an AI agent pull in context from outside the repo, like Jira tickets or internal docs. Press Enter for the full definition. bridge.
Android is Linux-based, and someone on the team has already run an Android simulator in a cloud agent, but only with a lot of step-by-step instructions. A more integrated experience that needs no instructions has not rolled out and has no date, so treat it as roadmap.
Frequently asked questions
Who is this guide for?
Developers and platform teams deciding whether a task should run locally, in a cloud agent or across parallel cloud subagents.
What should I do next?
Check the release facts above against the Cursor sources at the end of this page, then work through the steps in order.
Does a self-hosted cloud agent keep inference inside my network?
No. A self-hosted cloud agent runs its tools, such as file edits and terminal commands, on a worker inside your network, so it can reach on-prem repos and internal tools. Cursor still runs the agent loop and inference, which calls external model providers as the desktop app does. It suits strict network and compliance needs, not a fully on-prem AI stack.
How many cloud agents can I run at once, and how long do they take?
Cursor's docs say you can run as many as you want in parallel, and they don't need your computer to stay online. Each run works on its own branch, and a presenter in one Cursor webinar put a typical run at about 10 to 15 minutes at minimum, end to end. Delegate work you can hand off and check back on, not work you want to watch live.
Can I trigger a cloud agent automatically, without a person prompting it?
Yes. You can wire a webhook to start a cloud agent on an inbound event, such as every email to an enterprise inbox, with the API key injected into the agent so it runs unattended. The agent drafts a result grounded in your docs and data sources, and a person reviews it before anything ships.
Sources & last verified
- Cursor changelog: Cloud Environment Setup and Cloud Subagents
- Cursor docs: Agents Window
- Cursor blog: Development environments for your cloud agents
- Cursor blog: Cloud agent environment (Jul 30)
- Cursor docs: Cloud Agent Builds
- Cursor docs: Cloud Agent OIDC tokens
- Cursor docs: Cloud Agent metadata
- Cursor changelog: Cloud Agents and Cursor Harness Improvements (Aug 19)
- Cursor docs: Self-Hosted Cloud Run Worker Pools
- Cursor enterprise
- Cursor docs: Cloud Agents
- Cursor docs: Self-Hosted Machines
- Cursor docs: Team Pools
Cursor ships frequently. Facts verified against primary sources on October 28, 2026.