AI coding workflow
AI Coding Agents
An AI coding agent can inspect a repo, plan a change, call tools, edit files, run commands and hand back the result. Cursor runs agents in several places: local work in the editor, /in-cloud subagents, /loop, Automations, Bugbot review and SDK runs. The test is the same for each: whether the output is scoped, checked and reviewable.

On this page
- What does a reviewable agent task look like?
- How should a team run each agent task?
- What should you keep after the run?
- What's new in Cursor recently?
- Which agent surface should a team start on?
- Who can start an agent run, and whose budget does it spend?
- How many agents can one team run at once?
- What should a small team skip that a large one cannot?
What does a reviewable agent task look like?
Give the agent one named task, only the context it needs and a check you can rerun. A task shaped this way produces a diff small enough to review and a result you can repeat.
- Move
- Start with a bounded task
- Use this when
- You have a named owner, target files and a clear done state
- Proof to save
- Issue, files, checks and owner are named
- Move
- Give the agent context
- Use this when
- The repo has patterns the agent must follow
- Proof to save
- Prompt cites files, errors and constraints
- Move
- Review the diff
- Use this when
- The task changes production code
- Proof to save
- Changed files, test output and risks are visible
| Move | Use this when | Proof to save |
|---|---|---|
| Start with a bounded task | You have a named owner, target files and a clear done state | Issue, files, checks and owner are named |
| Give the agent context | The repo has patterns the agent must follow | Prompt cites files, errors and constraints |
| Review the diff | The task changes production code | Changed files, test output and risks are visible |
Each move leaves proof that a reviewer can check later.
Each move fails in its own way. Without a boundary, the agent edits files you never meant to open, and the diff becomes hard to read. Thin context fails more quietly: the code compiles and the tests pass, but the change ignores patterns the rest of the repo follows. Without a check you can rerun, you are taking the agent's word that the work is done.
Asking for a plan before the agent writes code is the easiest step to skip. It means a short wait while nothing visible happens, and the price of skipping it shows up later, in review.
If the plan names files you didn't expect, you learn that before any code exists. If it names the right files, you have a list to check the diff against. Once four hundred lines of diff are on screen, changing the approach means throwing that work away.
Interactive widget. Tab through its controls; the result updates in the panel below as you change them.
Open each stage to see what a reviewer should be able to inspect.
This is covered hands-on in Agent Mode Foundations — 6 short Units, free to read.
How should a team run each agent task?
The habit that matters most for a team is leaving a trail the next reviewer can follow. The steps below keep the prompt and its proof attached to the change.
- 1Pick one real backlog item with a clear owner and expected result.
- 2Add only the context the agent needs: files, failing output, constraints and done state.
- 3Ask for a plan before code when the task touches more than one file.
- 4Run checks that match the risk: unit test, typecheck, visual pass or review checklist.
- 5Capture the prompt, diff, result and reviewer note so the workflow can be repeated.
Match the effort to the change. A one-file fix needs a clear done state and a typecheck, and a plan adds little. A change across several files is where a plan pays for itself, and where the check should include tests and a reviewer who knows that code.
What should you keep after the run?
Keep whatever lets someone rerun the work or pick it up later. A finished task is the merged code plus a short trail that shows how it got there.
- The prompt or plan that shaped the work.
- The files changed and the reason each file changed.
- The command, screenshot or review note that proved the result.
- The rule, checklist or template you would reuse next time.
The last item pays off over time. A rule or template saved from one good run means the next run starts from what already worked, not from a blank prompt.
What's new in Cursor recently?
Cursor ships often, so advice about it can go out of date. The table summarizes Cursor's recent releases, so you can check this page against the current product. For each release's date and sources, see What's new in Cursor 2026.
- Surface
- Compile 2026
- What to know
- Cursor's June conference (June 16, per press coverage) centered on Origin, larger from-scratch model training and Cursor Mobile.
- Surface
- Origin
- What to know
- Early beta since August 17, 2026, on most paid plans: repos, pull requests with Code Tours, GitHub sync and a CLI. Standalone pricing and self-hosting are still unpublished.
- Surface
- Model and mobile
- What to know
- Composer 2.5The current Composer release, better at long-running tasks and at judging when a job needs a light touch versus deep work. Press Enter for the full definition. is available now. Cursor says it is training a larger model with SpaceXAI. Cursor Mobile now has its own product page.
- Surface
- Automations
- What to know
/automate, Slack emoji triggers, GitHub triggers for issue comments, reviews and workflow runs, computer use, PR defaults and memory cleanup.
- Surface
- 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.
- What to know
- Guided cloud environment setup, reusable snapshots,
.cursor/environment.json,/in-cloud,/autopilot(formerly/babysit) and local/cloud handoff.
- Surface
- Review
- What to know
- BugbotCursor's automated PR reviewer that posts inline findings and can push fix commits from isolated VMs. Press Enter for the full definition. averages about 90 seconds per review and finds 10% more bugs per review.
/reviewruns it locally before you push. Cursor's June changelog says Composer 2.5The current Composer release, better at long-running tasks and at judging when a job needs a light touch versus deep work. Press Enter for the full definition. now powers Bugbot, and these figures may change.
- Surface
- Design and Canvas
- What to know
- Design ModeA way to point at an element in Cursor's built-in browser and change it directly, instead of describing it in words. Press Enter for the full definition. supports multi-select and voice queueing. Canvases support Design Mode, context reports, Debug with Agent, full-screen sharing and prompt buttons.
- Surface
- SDK and run modes
- What to know
- SDK agents can use custom tools, auto-review, JSONL or custom stores, nested subagents and request IDs. Auto-review Run Mode runs known-safe calls, sandboxes shell commands where it can and sends the rest to a classifier.
- Surface
- Enterprise and pricing
- What to know
- Organizations sit above teams, and groups scope model access, spend and agent permissions. Teams launched with Standard and Premium seats and two usage pools, Cursor ModelsOn legacy Cursor plans, the monthly usage pool for Cursor's own models (Grok 4.7, Grok 4.6, Grok 4.5 and Composer 2.5), kept separate from the third-party Other Models pool. The X Subscription replaces it with one weekly pool. Press Enter for the full definition. and Other ModelsOn legacy Cursor plans, the monthly pool for supported third-party models from providers such as Anthropic, Google and OpenAI, separate from Cursor Models. On The X Subscription third-party models are billed from prepaid credit instead. Press Enter for the full definition.. Those seats are now legacy, and current Teams seats are Premium, Super and Ultra 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..
| Surface | What to know |
|---|---|
| Compile 2026 | Cursor's June conference (June 16, per press coverage) centered on Origin, larger from-scratch model training and Cursor Mobile. |
| Origin | Early beta since August 17, 2026, on most paid plans: repos, pull requests with Code Tours, GitHub sync and a CLI. Standalone pricing and self-hosting are still unpublished. |
| Model and mobile | Composer 2.5The current Composer release, better at long-running tasks and at judging when a job needs a light touch versus deep work. Press Enter for the full definition. is available now. Cursor says it is training a larger model with SpaceXAI. Cursor Mobile now has its own product page. |
| Automations | /automate, Slack emoji triggers, GitHub triggers for issue comments, reviews and workflow runs, computer use, PR defaults and memory cleanup. |
| 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. | Guided cloud environment setup, reusable snapshots, .cursor/environment.json, /in-cloud, /autopilot (formerly /babysit) and local/cloud handoff. |
| Review | BugbotCursor's automated PR reviewer that posts inline findings and can push fix commits from isolated VMs. Press Enter for the full definition. averages about 90 seconds per review and finds 10% more bugs per review. /review runs it locally before you push. Cursor's June changelog says Composer 2.5The current Composer release, better at long-running tasks and at judging when a job needs a light touch versus deep work. Press Enter for the full definition. now powers Bugbot, and these figures may change. |
| Design and Canvas | Design ModeA way to point at an element in Cursor's built-in browser and change it directly, instead of describing it in words. Press Enter for the full definition. supports multi-select and voice queueing. Canvases support Design Mode, context reports, Debug with Agent, full-screen sharing and prompt buttons. |
| SDK and run modes | SDK agents can use custom tools, auto-review, JSONL or custom stores, nested subagents and request IDs. Auto-review Run Mode runs known-safe calls, sandboxes shell commands where it can and sends the rest to a classifier. |
| Enterprise and pricing | Organizations sit above teams, and groups scope model access, spend and agent permissions. Teams launched with Standard and Premium seats and two usage pools, Cursor ModelsOn legacy Cursor plans, the monthly usage pool for Cursor's own models (Grok 4.7, Grok 4.6, Grok 4.5 and Composer 2.5), kept separate from the third-party Other Models pool. The X Subscription replaces it with one weekly pool. Press Enter for the full definition. and Other ModelsOn legacy Cursor plans, the monthly pool for supported third-party models from providers such as Anthropic, Google and OpenAI, separate from Cursor Models. On The X Subscription third-party models are billed from prepaid credit instead. Press Enter for the full definition.. Those seats are now legacy, and current Teams seats are Premium, Super and Ultra 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.. |
A summary only. The release tracker linked above gives each release's date and sources.
Which agent surface should a team start on?
Start local, in the editor, on work someone was going to do that week anyway. Real work gives you a fair test, because someone on the team already knows what a good result looks like. After that, the order that holds up is cloud runs, then /loop, then /automate, then the SDK. Cloud runs and automations need Premium or higher, a Teams or Enterprise plan, or a legacy plan that includes them, which leaves out Free and Plus.
Read that order as a supervision ladder. Each rung has fewer people watching the run. A local run happens in front of you, and you stop it when it goes somewhere strange. /in-cloud hands the next task to a subagent in its own VM and branch, so you inspect the result instead of the run. /loop reruns a prompt or skill at an interval you set.
An automation built with /automate goes furthest. It fires on a schedule, a Slack message, a GitHub event or a webhook, so it can run at three in the morning with nobody watching.
That makes automations the tempting place to begin, because a scheduled agent looks like free work. Start there, and on Monday morning you test your review habit against a queue of pull requests that arrived overnight. Agree on how those get reviewed before the first queue lands, and move up a rung only once reviewing the current one is routine.
Who can start an agent run, and whose budget does it spend?
Be exact about what an automation can do. It doesn't merge. When it changes code, it opens a pull request that a person reviews, and whoever clicks merge owns the change.
What automations change is who can start a run. Wire a code-touching automation to a Slack channel, and everyone in that channel can trigger an agent. A trigger that fires on every message in a busy channel also builds a queue. Narrow it with the trigger's filters, such as a keyword or regex on Slack messages. Then put the rest in the prompt: Cursor's docs suggest a quality bar for when the agent should open a pull request, comment or do nothing.
Scope the trigger before anything else. The automation guide covers the rest of the setup.
The SDK sits last on the ladder because of how it spends money. SDK runs draw on the same request pools as a developer prompting in the editor, and the spend shows up under the SDK tag in the team usage dashboard. A script that loops over a hundred files spends real money against somebody's budget. Whose budget depends on whether you gave it a user key or a service-account key.
How many agents can one team run at once?
As many as you can review properly, which is fewer than the interface suggests. The agent count is a property of the tool. The review count is a property of your team, and only the agent count shows up on screen.
Isolation solves the mechanical half of the problem. Two agents editing the same file leave you with conflicting edits, so give each one its own git worktree, an isolated checkout of the same repo. 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. supports worktrees directly. In the editor, the /worktree command starts one, and the CLI takes a --worktree flag.
Isolation does nothing for the constraint that matters. Four isolated agents still produce four diffs, and one person has to read them while holding four different intentions in mind.
So cap the unfamiliar surface, not the agent count. Two agents on a config change you understand cost less attention than one agent loose in a service nobody has read this year. Decide how many files you can read carefully today, and let the number of agents follow.
/review runs BugbotCursor's automated PR reviewer that posts inline findings and can push fix commits from isolated VMs. Press Enter for the full definition. or Security Review over your changes before you push. It returns review evidence for a person to weigh, and humans still own merge. That boundary slips first as the agent count climbs, because a tired reviewer will accept a passing bot check in place of reading the diff.
On a team of three, the ceiling is one person's afternoon. On a team of thirty, it depends on whether anyone owns the queue. A large team can have the review capacity but no rule about who spends it, and then agent diffs pile up with whoever is most conscientious. Name an owner for each queue.
What should a small team skip that a large one cannot?
A small team can skip nearly all of the control plane. Under roughly 10 people, one shared rules file, one convention about who launches cloud work and a habit of opening diffs carry a team further than any admin setting. What hurts at that size is weak context and weak review. Neither shows up on a dashboard, which is part of why teams skip them.
Past that size, the controls exist because informal agreement stops holding. On Enterprise, a group gives a cohort its own model access, spend limit and agent permissions without a new team. Admins set a monthly team-wide limit on additional usage. Enterprise accounts can also add pooled usage, one committed pool for the whole team, with member-level spend alerts on total spend, not only on additional usage.
API keys are the detail teams miss. SDK runs and scripted CLI runs authenticate with an API key, and any member can generate a user key without a new seat. On Enterprise, a service-account key doesn't take a seat either, and its usage draws on the team's pool like everyone else's. Set the spending limit before you point automation at it.
Timing matters more than which controls you pick. A group boundary drawn before anyone has run agents on real work encodes a guess about how that work will flow. The guess is usually wrong in both directions. It is too tight where people improvise, such as a model block that stops one project, and too loose where money leaks, such as a pilot group's high spend limit that nobody lowers afterward. Write the policy after the pilot, and soon after it.
Agent guides
An AI coding agent inspects code, plans changes, edits files and runs commands, then hands back a diff. How it differs from chat, and what you control.
Open guideOrchestrate coding agents by splitting work into small jobs, planning first, fanning out to sub-agents and reviewing every diff against tests.
Open guideChoose between Cursor's local and cloud agents by review tightness, setup, risk and handoff, and check that your plan includes cloud agents.
Open guideBuild a pull request review agent that reads the diff, repo rules and test status, comments on risk and leaves the merge decision to a person.
Open guideBuild an agent that reads a failing CI job, proposes a narrow patch and reruns the check, once you know what Cursor's cloud agents already fix.
Open guideBuild a docs update agent that runs on each merged pull request, drafts the change under /docs and posts it to Slack for a person to check.
Open guideBuild a bug triage agent that turns a Linear or GitHub ticket, or a pasted Slack thread, into a scoped engineering task with evidence attached.
Open guideCursor Agent docs (Learn hub)
A Cursor side chat runs beside your main chat and inherits its history as hidden context. How to open one, bring answers back, and its limits.
Open guideShare a Cursor conversation as a read-only team or public link. Who can open it, what secret redaction can miss, which plans have it and the daily cap.
Open guideAgentic coding means directing an agent toward a goal instead of typing every line. How the loop works in Cursor, and where Plan mode and Cloud Agents fit.
Open guideAI pair programming puts you and an agent on the same task. How the loop runs in Cursor, from Cmd+I to the pull request, and what you still own.
Open guideGenerated commit messages, Resolve in Chat for merge conflicts, the Made with Cursor trailer and Cursor Blame. What Cursor adds on top of Source Control.
Open guideMy Machines runs Cloud Agent tool calls on your own laptop, devbox or VM through an outbound worker. Setup, credentials, triggers and troubleshooting.
Open guideTeam Pools run Cloud Agent tool calls on workers your Enterprise team operates. How to start pool workers, route runs, scale capacity and allow network hosts.
Open guideSelf-Hosted Machines run Cloud Agent tool calls on hardware you manage. When to choose them, what leaves your network, and what each worker setup needs.
Open guideCloud Agent webhooks POST a statusChange event when an agent finishes or errors. Set one up in the v0 API, verify its HMAC-SHA256 signature, read the payload.
Open guideA Cursor Project gives larger work a coordinator agent that plans, delegates to cloud agents and keeps shared context. See the plans, setup and subscriptions.
Open guideCursor Rollouts writes a plan when a pull request opens, checks the change against your telemetry after it deploys, and opens issues on regressions.
Open guideEnterprise teams connect Grok Bot computers to private networks with Team Setup Scripts and a client like Tailscale. See the steps, rules and limits.
Open guideGrok Bot computer setup hangs behind Zscaler and other TLS-inspecting gateways. See which domains to allow and exempt, and how to test the fix on a device.
Open guideThe eight Grok Bot roles Cursor documents, from sales outbound to chief of staff: what each connects, where its prompt stops and how to make it durable.
Open guideGrok Bot inference hooks (beta) send governed model requests, signed, to your AI security server for an allow or deny verdict. Setup, modes and request format.
Open guideScript Cursor Cloud Agent environments with the beta Environments API: create and update them, read history, start Builds and manage secrets.
Open guideAdd an MCP server to Cursor so the agent can use outside tools: one-click installs, mcp.json config, stdio vs remote, and fixing "no tools found".
Open guideThe prompting habits that make Cursor's agent reliable: state the goal and its constraint, point at the right files, plan first and say how to verify.
Open guideHow Cursor Agent works: the instructions, tools and model behind each run, how to open it with Cmd+I, and how to undo or steer a run.
Open guideWhen to use the Agents Window vs the classic editor: parallel cloud agents, diffs, worktrees, /in-cloud subagents and enterprise rollout controls.
Open guideUse Debug Mode when the agent's guesses fail: it forms hypotheses, adds logging, has you reproduce the bug, then makes a targeted fix.
Open guidePoint at your running app in the Agents Window, leave notes on elements or areas, and let Agent edit the code behind them.
Open guideAgent Review checks your local changes inside Cursor. Run it after commits, with /agent-review or from Source Control, at Quick or Deep depth.
Open guideCursor's Plan Mode has the agent research your codebase and write a plan you can edit before it changes code. Switch with Shift+Tab, review, then build.
Open guideCursor's Browser tool lets the agent click, type, take screenshots and read console and network logs in a real browser. Each action needs approval by default.
Open guideCursor's agent runs shell commands in your own terminal. Your Run Mode decides when a command runs, when Cursor asks first, and when it uses the sandbox.
Open guideA Cursor canvas shows an agent's dashboard, analysis or report as an interactive view beside the chat. You can reopen, edit and rerun it with fresh data.
Open guideSet up a Cloud Agent environment so the agent can run and test code: repos, install and start commands, Builds, secrets, AWS roles and private networks.
Open guideWhat a Cursor cloud agent can do: a desktop VM it controls, PR artifacts, MCP tools, CI fixes, event subscriptions and OIDC tokens for your cloud.
Open guideCursor Automations run cloud agents on a schedule or on events from GitHub, GitLab, Bitbucket Cloud, Slack, Linear, Sentry, PagerDuty or a webhook.
Open guideCursor's advice for reliable cloud agent runs: set up the environment first, check access, add skills, AGENTS.md and rules, and give the agent good tools.
Open guidePick where Cursor Cloud Agents run: Cursor-managed VMs, My Machines or Team Pools. The agent loop stays in Cursor's cloud in every case.
Open guideHow Cursor Cloud Agents protect secrets, sign commits, retain data, and control outbound network access with three egress modes and allowlists.
Open guideWhat each Cloud Agents dashboard setting does: environments and Builds, default model and repo, network access modes, security toggles and team follow-ups.
Open guideHow Cursor Cloud Agent Builds prepare environments ahead of time, what belongs in install versus start, and what happens when a Build fails.
Open guideEvery field in .cursor/environment.json, checked against Cursor's schema, plus when saved environments override the file and when install runs.
Open guideOne Cursor Cloud Agent environment can span several repos. Set up the repo group, scope its secrets, and run tasks that open a PR in each repo they change.
Open guideCursor's Security Agents scan code for vulnerabilities: a Security Reviewer on pull requests and a Vulnerability Scanner on a cron schedule.
Open guideCursor's Approval Agents, now PR Routing & Approval, assign reviewers and approve low-risk PRs using policy files, risk scores and Bugbot findings.
Open guideMention @Cursor in a Teams chat or channel to start a Cloud Agent. See how to install it, pin the repo and model, and follow up from a thread.
Open guideA Cursor Agent Skill packages a workflow in a SKILL.md file that the agent applies when relevant or you run with /skill-name. How to write, store and share one.
Open guideWhat Cursor's Gmail, Drive and Calendar plugins can read and change, how to install each one, and how to keep sends and edits behind review.
Open guideHow the Cursor SDK runs Cursor's agent from TypeScript or Python, what the local and cloud runtimes mean, which API keys work, and what shipped recently.
Open guideFrequently asked questions
Who is this guide for?
Developers, AI engineers and DevEx teams who build coding agents or are adopting them.
What should I do next?
Pick one real task from your backlog and run it through the steps on this page. Keep the prompt, the diff and the check that proved the result.
Which Cursor agent surface should a team start with?
Start with local Agent in the editor, on work someone was going to do that week anyway. Then move to cloud runs, /loop, /automate and the SDK, in that order. Each step has fewer people watching the run, so move up only as fast as your review habit keeps pace.
How many coding agents can one team run at once?
As many as the team can review properly. Give each agent its own git worktree so that two agents never edit the same file. Then limit how much unfamiliar code you take on in a day, because every diff still lands on a person who has to read it.
Does a Cursor automation merge code by itself?
No. When an automation changes code, it opens a pull request that a person reviews, and whoever clicks merge owns the change. The larger risk is who can start one, so narrow each trigger with the filters it offers and set a quality bar in the prompt for when the agent should do nothing.
Sources & last verified
- Cursor agent best practices
- Cursor Learn: working with agents
- Cursor Learn: context
- Cursor docs: prompting agents
- Cursor docs: Cloud Agents
- Cursor docs: Automations
- Cursor docs: Skills
- Cursor docs: Worktrees
- Cursor CLI usage
- Cursor docs: Headless CLI
- Cursor TypeScript SDK
- Cursor docs: Bugbot
- Cursor docs: Security Agents
- Cursor docs: Models and pricing
- Cursor docs: Legacy Cursor plans
- Cursor docs: Team pricing
- Cursor Help: Spend alerts
- Cursor docs: Service accounts
Cursor ships frequently. Facts verified against primary sources on October 28, 2026.