Cloud Agents
Cursor Cloud Agents: Choosing a Runtime
Cursor offers three runtimes for Cloud Agents: Cursor-managed Cloud Agents that run each agent in an isolated cloud VM, My Machines that execute tool calls on a single user's laptop or VM, and a Self-Hosted Pool that runs an org-managed worker fleet. In every case the agent loop runs in Cursor's cloud; only where tool calls execute changes. Cursor says managed Cloud Agents are sufficient for over 80% of customers.
On this page
What are the three runtime options?
Cursor splits 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. into one managed runtime and two self-hosted paths. The shared fact is that the agent loop always runs in Cursor's cloud; the runtime choice only changes where tool calls execute and who operates that execution environment. The cards below summarize each option as Cursor describes it.
Runs each agent in an isolated cloud VM with managed lifecycle, saved environments, artifact capture, and dashboard controls for secrets and network access. No infrastructure to run, elastic concurrency, and the full feature surface. Cursor calls this the recommended path for most teams.
Runs tool calls on hardware you control: one user's laptop, devbox, or VM. The agent loop still runs in Cursor's cloud. Best for personal or small-scale workflows where a user already has the right checkout, tools, credentials, and private network access.
An org-managed worker fleet that runs tool calls on hardware you control. The agent loop still runs in Cursor's cloud. Fits Enterprise teams that want centralized ownership of worker hardware or need to route work to specific fleets.
When should I choose self-hosted over Cursor-hosted?
Cursor frames the choice as a decision tree: if any answer is "yes," pick a self-hosted path; otherwise managed 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. are the default. The list below walks the three questions Cursor poses, each of which points to self-hosting when it applies.
- Perimeter constraint: Do written policies require repository data and agent compute to stay inside your perimeter? Cursor notes this is usually required by compliance or security policy, not just a team preference.
- Network reach: Do agents need in-network services that Tailscale, PrivateLinkAn AWS feature that keeps traffic to a service on your private network instead of the public internet., and egress allowlists cannot cover? Most private networks work with Cursor-hosted agents via those mechanisms.
- Hardware or disk: Do you need a custom OS, special hardware, or persistent local disk for a very large repo? Cursor-hosted agents run on Ubuntu VMs and use a Dockerfile to customize tooling; if ARM is required, Cursor says to talk to your enterprise account team.
If any answer was "yes," Cursor points to two self-hosted paths: My Machines (one user's laptop, devbox, or VM) and Self-Hosted Pool (an org-managed worker fleet).
Why start with managed Cloud Agents?
Cursor calls managed 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. usually the lowest-operations way to give agents secure access to code and internal systems, and recommends using the managed path when you can configure access through its built-in controls. The list below covers the access mechanisms Cursor documents for the managed path.
- Cloud Agent environments with setup commands, Dockerfiles, snapshots, and secrets.
- Network access controls that restrict outbound domains by user, team, or environment.
- Tailscale or a similar private-network client inside the environment when agents need to reach services in your VPC or intranet.
- Private connectivity for private GitHub Enterprise Server, GitLab Enterprise, private source control APIs, and related webhook traffic.
This lets Cursor operate the agent infrastructure after setup while your team controls which repos, secrets, and network resources each environment can reach. On the managed path your responsibilities are first-time environment configuration, secrets, repository access, and network policy; Cursor manages the host and environment lifecycle after that.
When do My Machines and Self-Hosted Pool fit?
The two self-hosted paths serve different scales. My Machines is for personal or small-scale workflows on a specific user's machine, while Self-Hosted Pool is for Enterprise teams that want centralized ownership of worker hardware. The table below maps each to the cases Cursor documents.
- Path
- My Machines
- Use it for
- A developer's devbox or remote workstation; a one-off repo that depends on local state you do not want to recreate in the cloud; a quick test before building a managed worker pool
- What you own
- The machine, worker process, local checkout, credentials, uptime, disk, network access, and keeping the machine in a clean state
- Path
- Self-Hosted Pool
- Use it for
- Service account authentication instead of per-user login; Kubernetes, autoscaling, labels, and fleet monitoring; dedicated hardware such as GPU or high-memory build machines; company-managed hosts that execute all terminal commands, file edits, browser actions, and local MCPModel Context Protocol. A standard that lets an AI agent pull in context from outside the repo, like Jira tickets or internal docs. servers
- What you own
- Hosts, images, VM resets, capacity, autoscaling, worker updates, monitoring, secrets, network access, and incident response
| Path | Use it for | What you own |
|---|---|---|
| My Machines | A developer's devbox or remote workstation; a one-off repo that depends on local state you do not want to recreate in the cloud; a quick test before building a managed worker pool | The machine, worker process, local checkout, credentials, uptime, disk, network access, and keeping the machine in a clean state |
| Self-Hosted Pool | Service account authentication instead of per-user login; Kubernetes, autoscaling, labels, and fleet monitoring; dedicated hardware such as GPU or high-memory build machines; company-managed hosts that execute all terminal commands, file edits, browser actions, and local MCPModel Context Protocol. A standard that lets an AI agent pull in context from outside the repo, like Jira tickets or internal docs. servers | Hosts, images, VM resets, capacity, autoscaling, worker updates, monitoring, secrets, network access, and incident response |
My Machines is not an org-wide fleet system: each worker belongs to the user who started it, targets the repo where it was started, and must stay online while sessions run.
Cursor notes that if your primary requirement is private network access, you should try managed 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. with network controls, Tailscale, or private connectivity before standing up a Self-Hosted Pool. The tradeoff of a pool is operational ownership: your team patches and flashes images, resets VMs between runs, manages capacity, rotates credentials, monitors health, and handles host failures.
How does the security model differ across runtimes?
All three options support Privacy ModeCursor's setting that routes requests under zero-data-retention terms so providers don't store or train on your code. and controlled secrets. Cursor says the main difference is where tool execution happens and who operates that execution environment. The table below contrasts the three runtimes on the questions Cursor documents.
- Question
- Where does the agent loop run?
- Managed Cloud Agents
- Cursor cloud
- My Machines
- Cursor cloud
- Self-Hosted Pool
- Cursor cloud
- Question
- Where do tool calls run?
- Managed Cloud Agents
- Cursor-managed isolated VM
- My Machines
- Your machine
- Self-Hosted Pool
- Your worker
- Question
- Who manages host and environment lifecycle?
- Managed Cloud Agents
- Cursor, after first-time environment configuration
- My Machines
- You
- Self-Hosted Pool
- Your team
- Question
- How do agents reach private resources?
- Managed Cloud Agents
- Environment networking, allowlists, Tailscale or similar clients, and private connectivity for supported source control paths
- My Machines
- Your machine's existing network
- Self-Hosted Pool
- Your worker fleet's network
- Question
- Best operational fit
- Managed Cloud Agents
- Most teams and repos
- My Machines
- Individual users and specific machines
- Self-Hosted Pool
- Centralized enterprise fleets
| Question | Managed Cloud Agents | My Machines | Self-Hosted Pool |
|---|---|---|---|
| Where does the agent loop run? | Cursor cloud | Cursor cloud | Cursor cloud |
| Where do tool calls run? | Cursor-managed isolated VM | Your machine | Your worker |
| Who manages host and environment lifecycle? | Cursor, after first-time environment configuration | You | Your team |
| How do agents reach private resources? | Environment networking, allowlists, Tailscale or similar clients, and private connectivity for supported source control paths | Your machine's existing network | Your worker fleet's network |
| Best operational fit | Most teams and repos | Individual users and specific machines | Centralized enterprise fleets |
Frequently asked questions
Does choosing self-hosted move the agent loop out of Cursor's cloud?
No. Self-hosted paths run tool calls on hardware you control through My Machines or a Self-Hosted Pool, but the agent loop still runs in Cursor's cloud. The runtime choice only changes where tool calls execute and who operates that execution environment.
What OS do Cursor-hosted Cloud Agents run on, and can I use ARM?
Cursor-hosted agents run on Ubuntu VMs, and you use a Dockerfile to customize tooling. If ARM is required, Cursor says to talk to your enterprise account team.
Which runtime should most teams pick?
Cursor-managed Cloud Agents. Cursor states they are sufficient for over 80% of customers and calls the managed path the recommended choice for most teams and the lowest-operations way to give agents secure access to code and internal systems.
Sources & last verified
- Cursor Docs - Cloud Agent Choose Runtime
- Cursor - My Machines
- Cursor - Self-Hosted Pool
- Cursor - Cloud Agent Setup
- Cursor - Cloud Agent Security and Network
- Cursor - Private Connectivity
Cursor ships frequently. Facts verified against primary sources on June 29, 2026.