Guide
Cursor Remote Control: Drive Agents From Your Phone
Remote Control is Cursor's documented feature for directing agents that run on your own computer from the iOS app. It works because one backend serves three surfaces: the iPhone app, cursor.com/agents and the desktop Agents window. Your desktop needs Cursor 3.9.8 or later, has to stay awake and online, and the workspace must be Git-backed.
On this page
What is Remote Control in Cursor?
Remote Control is the official name in Cursor's docs for driving a local agent, one executing on your own machine, from your phone. It is the part of Cursor's mobile story that goes beyond cloud agents: the iOS launch post pitches launching always-on agents in the cloud, or "control agents running on your computer from your phone." Cloud agents run on Cursor's machines and never needed your desktop; Remote Control is specifically about the machine on your desk.
That distinction matters because local agents are where much real work happens: your checkouts, your environment, your build caches. Remote Control means stepping away from the desk no longer means abandoning a run in progress.
This is covered hands-on in Agent Mode Foundations — 6 short modules, free to read.
How do the iOS app, the web and the desktop fit together?
The architecture is one backend, three windows onto it. An agent started on any surface shows up on the others, which is what makes handoff feel like continuing rather than reconnecting. Each surface has a distinct job.
- Surface
- Cursor for iOS
- What it is
- Native iPhone app, public beta since June 29, 2026 (iOS 26.0+, paid plans)
- Where it shines
- Supervision: push notifications, lock-screen Live Activities for up to eight agents, voice dictation, merge controls.
- Surface
- cursor.com/agents
- What it is
- The web surface, in any desktop, tablet or phone browser
- Where it shines
- Configuration: environments, secrets, 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, automations, plus admin, billing and usage all live here.
- Surface
- Desktop Agents window
- What it is
- The native desktop surface where local agents execute
- Where it shines
- The work itself: local runs against your real checkout, and the Remote Control toggle that lets the phone drive it.
| Surface | What it is | Where it shines |
|---|---|---|
| Cursor for iOS | Native iPhone app, public beta since June 29, 2026 (iOS 26.0+, paid plans) | Supervision: push notifications, lock-screen Live Activities for up to eight agents, voice dictation, merge controls. |
| cursor.com/agents | The web surface, in any desktop, tablet or phone browser | Configuration: environments, secrets, 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, automations, plus admin, billing and usage all live here. |
| Desktop Agents window | The native desktop surface where local agents execute | The work itself: local runs against your real checkout, and the Remote Control toggle that lets the phone drive it. |
One shared backend, per Cursor's docs. On Android, the web surface stands in for the app; see the [Android guide](/guides/cursor-android).
What does Remote Control of a local agent require?
Cursor documents the requirements precisely, and each one follows from the same fact: the tool calls execute on your machine, not in the cloud. The phone is a steering wheel, not the engine.
- Desktop version
- Cursor 3Cursor's agent-forward interface (also called the agent window or Glass), built to run and supervise many agents at once rather than edit one file. Press Enter for the full definition..9.8 or later.
- Machine state
- The desktop stays awake and online. If it sleeps, the agent stops, because the work runs there.
- Workspace
- Git-backed with a remote. An untracked scratch folder doesn't qualify.
- Enablement
- Turn on Remote Control in the desktop Agents Window settings.
- Teams / Enterprise
- An admin must enable Remote Control for the organization before members can use it.
- Privacy setting
- Cloud agents require Privacy ModeCursor's setting that routes requests under zero-data-retention terms so providers don't store or train on your code. Press Enter for the full definition. (not Legacy). Cursor says it does not train on your code and retains it only to run the agent.
Per cursor.com/docs/cloud-agent/mobile, checked July 16, 2026. The app is beta; expect these to move.
Cursor labels the iOS app a beta and says features may change before general availability. The version floor, the admin gate and the Git requirement are all worth re-verifying in the docs before you standardize a team workflow on them.
How do you start at your desk and supervise from your phone?
The workflow that makes Remote Control click is the handoff: begin a run where the context is richest, your desktop, then carry supervision in your pocket. Here is the sequence end to end.
- 1Start the run at your desk: kick off a local agent in the desktop Agents window, or a cloud agent from any surface.
- 2Enable Remote Control in the Agents Window settings, and leave the machine awake and online.
- 3Open Cursor for iOS. The same run is already listed, because the app reads the same backend.
- 4Supervise from the phone: follow the log, answer the agent's questions, redirect with typed or dictated follow-ups.
- 5Review the result in the app: full diffs, commits, deployments and review threads all render on the phone.
- 6Close it out: merge with squash, toggle auto-merge, update the branch, or leave it for a desktop-grade review in the morning.
Cursor's launch posts frame the reverse flow too: start an agent from the phone on the way in, then pick the work up in the editor at your desk with the context intact. The backend doesn't care which surface initiated; that is the entire point of sharing it.
Is it safe to merge a pull request from your phone?
Mechanically, yes: a merge from the iOS app goes through the same pull request as a merge from anywhere else. Branch protections, required checks and code-owner rules still gate it. The app gives you the controls (merge with squash, mark ready for review, update the branch, toggle auto-merge, publish, close) and no bypass around your repo's rules.
The judgment question is different from the mechanical one. A phone screen shows you a diff; it does not give you the desktop's room to read surrounding code, run the change, or think. A policy that works in practice: supervise, comment and redirect freely from the phone, merge the small low-risk changes, and hold anything touching auth, payments, data migrations or infrastructure for a desktop review. Write down which actions your team treats as phone-safe, so the boundary is a decision rather than a mood.
Remote Control means an unattended, online computer executing tool calls. Treat it like a running CI worker: keep secrets and production access behind the same policy you apply to desktop and cloud agents, and don't leave Remote Control enabled on a machine you aren't coming back to.
Frequently asked questions
Can the Cursor mobile app control agents on my desktop?
Yes. Remote Control, documented in Cursor's iOS docs, lets the iPhone app direct agents running on your own computer. The desktop needs Cursor 3.9.8 or later, must stay awake and online, the workspace must be Git-backed with a remote, and the feature has to be enabled in the desktop Agents Window settings.
Does my computer need to stay on for Remote Control?
Yes. Tool calls execute on your local machine, so the desktop has to remain awake and connected for the agent to keep working. If you need runs that survive your laptop closing, use a cloud agent instead; those run on Cursor's machines and are supervised the same way from the phone.
Do I need admin approval to use Remote Control on a Teams plan?
On Teams and Enterprise plans, yes: an administrator must enable Remote Control for the organization before members can use it. On individual paid plans you enable it yourself in the desktop Agents Window settings.
Can I merge pull requests from the Cursor iOS app?
Yes. The app supports merging with squash, marking ready for review, updating the branch, toggling auto-merge, publishing and closing. Your repository's branch protections and required checks still apply; the phone gets no special bypass.
What is the difference between a cloud agent and Remote Control?
A cloud agent runs on Cursor's infrastructure and keeps working with your devices off. Remote Control drives an agent executing on your own computer, which must stay awake and online. Both appear in the iOS app and at cursor.com/agents because all surfaces share one backend.
Sources & last verified
- Cursor docs — Cursor for iOS
- Cursor blog — Build from anywhere with Cursor for iOS
- Cursor blog — Cursor on web and mobile
Cursor ships frequently. Facts verified against primary sources on July 16, 2026.