Agents
Hand tasks to Cloud Agents, formerly Background Agents, run several agents at once, and use subagents for noisy or parallel work.
-
When Should You Use Subagents in Cursor? Use a subagent when a piece of work is noisy, can run in parallel, or needs an independent check. Level 4: Multi-tool systems
- 10Parallel Explore searchesin the time of one main-agent search
- 5xTokens for five subagentsroughly, against a single agent
-
How Do You Hand a Task to a Cursor Cloud Agent? Background agents are now called Cloud Agents. Level 4: Multi-tool systems
- 1Describe the task
- 2Clones repo, makes branch
- 3Works on its own VM
- 4Opens a PR
- 5You review
-
How Do You Run Several Cursor Agents at Once? Use the Agents Window, Cursor's agent-first interface. Level 4: Multi-tool systemsQuick local taskWeeks of work
- Worktree
- Cloud Agent
- Project
-
How Do You Set Up a Cloud Agent Environment in Cursor? Open the Cloud Agents dashboard at cursor.com/dashboard/cloud-agents, or the Agents Window, and start guided setup. Level 4: Multi-tool systems
- .cursor/environment.jsononly if the location points to it
- Team saved environment
- Personal saved environmentchecked first
Three kinds of agent worth separating
Agent in your editor works alongside you. A Cloud Agent, which Cursor used to call a background agent, runs on its own machine and returns a pull request. A subagent is a helper the main agent starts, with its own context window. Telling these apart helps, because they cost, fail and get reviewed differently.
The limit is your environment and your review
Cursor calls environment setup the most important step for Cloud Agents, since an agent that can't run your tests can't check its work. The other limit is you. Every parallel agent produces a diff that someone has to read, so start with a few independent tasks and increase from there.
What happened to Cursor background agents?
They're now called Cloud Agents. Cursor's help still explains the term, and says each one runs on a dedicated virtual machine and can open a pull request when it finishes.
Which Cursor plans include Cloud Agents?
On The X Subscription, Premium and higher, Teams and Enterprise include them, while Free and Plus don't. Legacy Start, Pro, Pro+ and Ultra plans also include them.
How do I start a Cursor Cloud Agent?
Select Cloud in the dropdown under the Agent input, go to cursor.com/agents, or mention @cursor in Slack, GitHub or Linear. A source control connection is needed first.
How many agents can I run at once in Cursor?
Cursor's docs say you can run as many Cloud Agents as you want in parallel. Each subagent uses its own tokens, though, so five in parallel use roughly five times as many as one.