Edit: Due to Cursor pricing changes, I have moved to Claude Code (that already has this feature). I will no longer be maintaining the project and recommend you fork it and make changes if needed.

Cursor Local Remote

Control Cursor from your phone, tablet or any browser on your local network. Great for monitoring and nudging Cursor while in the bathroom, watching a movie or cooking food.

A local web UI that talks to Cursor's CLI agent on your machine. No cloud, accounts or other bs — just on your local network. Also added some rudimentary security so that you need a key to access it incase you have many in a Wifi network. Important to only use this on trusted network that are safe, because the security is easy to bruteforce if you are in the same network.

Demo

https://github.com/user-attachments/assets/6b2284fd-0e3d-46c9-ae63-86bbd672ad72

Good to know

This is essentially an easy way to use the Cursor CLI from your phone or any other device on your network.

You can start new sessions from the remote UI and they work fully: the agent runs, edits files, executes commands, everything. However, sessions started remotely won't appear in Cursor's desktop sidebar. This is a Cursor limitation, it stores conversation state in an internal in-memory store that can't be written from outside the process.

The remote UI can see all sessions, both ones started in the IDE and ones started remotely. You can monitor active desktop sessions in real time, browse and resume past sessions, or start fresh ones. Messages sent from the remote won't show up in the IDE's chat view, but the work the agent does (file edits, commands) happens on your machine either way.

Install

npm install -g cursor-local-remote

Then start it:

clr

A QR code pops up in your terminal — scan it from your phone and you're connected.

Updating

clr --update

Or the same command as install: npm install -g cursor-local-remote

I'm actively using this myself on a daily basis, so bugs get noticed and fixed quickly.

Features

• QR connect — scan to connect your phone instantly and continue with phone coding session
• Full agent control — send prompts, pick models, switch modes, stop/retry from any device
• Live streaming — watch responses, tool calls, and file edits in real time
• Multi-project — switch between all your Cursor projects, star favorites, browse sessions across workspaces
• Git panel — view diffs, commit, push, pull, switch branches — all from the UI
• Terminal access — Access terminal from phone/browser
• Session management — browse, resume, archive, and export past sessions
• PWA ready — install as an app on your phone's home screen
• Notifications — tab title flash + sound when agent finishes, optional webhook for push-to-phone (e.g. Discord)

Notifications

When the agent finishes a task, CLR notifies you in two ways:

Built-in (no setup): If the browser tab is in the background, the tab title flashes ("Done! - CLR" or "Error - CLR"), the favicon gets a colored badge, and a sound plays. When you switch back to the tab you'll see a banner showing the result.

Webhook (optional): For real push notifications — even with the phone locked or browser closed — you can configure a webhook URL in Settings. When the agent completes, CLR sends a POST with a JSON payload: