Cursor has promoted Background Agents from beta to general availability for all Pro and Business subscribers. The feature lets you hand off a task to an agent that runs in a separate session — including terminal access, file edits, and web search — while you continue working in your main editor window.
What it actually does
A background agent is a separate Cursor session running headlessly. You give it a task with natural language, it plans and executes, and you get a summary when it’s done. The agent can:
- Run shell commands and read their output
- Edit files (with a diff you review before merging back)
- Search the web for documentation or error messages
- Iterate on test failures without your involvement
The key word is headless — it’s not blocking your keyboard. You can start an agent to “write tests for the UserService class, make them pass, and commit” and then keep working on something else.
What it doesn’t do
Background agents are not fully autonomous. They pause and ask for input when they hit a decision they can’t make confidently — whether to delete a file, which of two refactoring approaches to take, how to handle an ambiguous requirement. This is by design and appropriate for a general-purpose coding tool.
Tasks that require visual judgment (UI changes, layout decisions) don’t work well. The agent can modify your CSS, but it can’t tell if the result looks right without a browser preview loop, which the current version doesn’t support.
Practical use cases
The tasks where background agents make the most sense are well-scoped and mechanical:
- Writing test coverage for a class you just wrote, while you move on to the next feature
- Running a linter with auto-fix on a set of files and producing a clean commit
- Generating boilerplate for a new endpoint (controller, service, migration, spec) from a description
- Updating documentation after a function signature change
For these tasks, the cycle time goes from “I’ll do this after I finish the current thing” to “it’s already done.”
Access and pricing
Background Agents are included in Cursor Pro ($20/month) and Business plans. There’s no separate charge per agent run, though consumption counts against your monthly usage quota. Heavy agent users on the Pro plan may hit limits faster than before.
Business plan users get priority queue access, which matters if background agent usage becomes heavy across a team — the GA launch will presumably stress-test the infrastructure.
The feature requires Cursor 0.42 or later. Update via the Help menu or re-download from cursor.com.