8 min readRemoot team

How to Run Cursor Agent From Your Phone

A step-by-step guide to running and supervising Cursor Agent from iOS or Android with Remoot: install the bridge extension, pair with a QR code, trust a project, and approve agent actions on the go.

Cursor Agent is good at long-running work: refactors, test fixes, multi-file edits. The catch is that long-running work doesn't need you at the desk — it needs you to check in. You review what the agent did, approve the next step, and walk away again. That check-in loop is exactly what a phone is for.

This guide walks through the full setup with Remoot: installing the bridge extension in Cursor, pairing your phone, trusting a project, and then starting and supervising an agent run from iOS or Android. It takes about five minutes end to end.

What you need

Your code never leaves your machine wholesale. The bridge streams agent status, diffs you ask to see, and approval prompts over an encrypted relay — the desktop stays the source of truth. If you want the details, read our architecture post.

Step 1 — Install the bridge extension

In Cursor, open the Extensions panel and search for Remoot, or install it straight from the marketplace link above. The extension is called Remoot: Bridge for Copilot & Cursor, published by Creatorium.

Once installed, a Remoot icon appears in the sidebar. The extension runs a small background daemon that keeps the connection alive even when the editor window isn't focused, and it can prevent your machine from sleeping mid-run if you allow it.

Step 2 — Pair your phone with a QR code

Open the Remoot panel in Cursor and choose Pair device. You'll see a QR code. On your phone, open the Remoot app and scan it.

Remoot pairing QR code displayed in the IDE, ready to be scanned by the mobile app
Pairing screen in the IDE — scan once, the device stays trusted.

Pairing is a one-time handshake: the QR code carries a short-lived token, and after the handshake your phone becomes a trusted device for that workstation. There is no account-wide access — trust is per device and revocable from the extension at any time.

Step 3 — Trust a project

Remoot won't expose every folder on your machine. You explicitly mark the projects you want reachable from your phone — everything else stays invisible to the app.

Animated walkthrough of marking a project folder as trusted in the Remoot extension
Trusted projects: only the folders you opt in are visible from mobile.

Step 4 — Start an agent run from your phone

With the pairing done, open the project in the Remoot app. You get a chat-style view backed by Cursor on your desktop. Pick Agentmode (Ask and Plan modes are there too), type a task the way you would in Cursor's agent panel, and send it:

Example prompt
Migrate src/api/client.ts from axios to fetch.
Keep the retry logic, update the tests, and run them.

The agent runs on your workstation with your local toolchain, your git state, and your Cursor configuration — the phone is a remote control, not a second environment. You'll see the agent's progress stream in live: files being edited, commands being proposed, test output.

Animated demo of driving a Cursor Agent session from the Remoot mobile app
An agent run supervised from the phone: prompt, live progress, approvals.

Step 5 — Approve, inspect, repeat

When the agent wants to do something that needs sign-off — run a shell command, apply a bigger change — the approval prompt lands on your phone as a push notification. From there you can:

  1. Approve or reject the pending action with one tap.
  2. Open the file tree and preview any file the agent touched before deciding.
  3. Send a follow-up prompt to redirect the agent if it drifted.

The full action history stays in the app, so a check-in after an hour away is a scroll, not an archaeology session.

Honest limitations

That's the whole loop: pair once, trust a project, and Cursor Agent stops being tied to your chair. The setup below takes about a minute.