Setup Guide

Getting Started with
CRSR</>Mobile

Control Cursor from anywhere using your phone. This guide will walk you through every step to get set up.

Before You Begin

Make sure you have the following:

  • Cursor IDE installed

    Download from cursor.com/download if you haven't already

  • A CRSR Mobile account

    You should already have one if you're viewing this page while logged in

  • An iPhone or Android phone

    iOS 15+ or Android 10+ recommended

  • Internet connection on both devices

    Your computer and phone need to be online (they don't need to be on the same network)

About Your AI Setup

CRSR Mobile controls Cursor on your computer. Your AI provider usage depends on your Cursor setup. The mobile app mirrors your desktop session events and lets you approve actions from your phone.

Step 1: Install the CRSR Mobile Bridge Extension

1

Download and Install the Extension

The CRSR Mobile Bridge extension connects your Cursor IDE to your mobile device. Here's how to install it:

AInstall from VSIX file (Recommended)

  1. 1.Download the extension file by clicking the button below
  2. 2.Open Cursor IDE on your computer
  3. 3.
    Open the Command Palette:
    • • Mac: Press Cmd + Shift + P
    • • Windows/Linux: Press Ctrl + Shift + P
  4. 4.Type Install from VSIX and select "Extensions: Install from VSIX..."
  5. 5.Navigate to your Downloads folder and select the cursor-mobile-bridge.vsix file
  6. 6.Click "Install" and wait for the installation to complete
  7. 7.Reload the window to activate the extension: Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows), then type "Reload Window" and select it

BVerify the Extension is Installed

  1. 1.Open the Extensions panel in Cursor (click the puzzle piece icon in the left sidebar, or press Cmd/Ctrl + Shift + X)
  2. 2.Search for "Cursor Mobile" in the installed extensions
  3. 3.You should see "Cursor Mobile Bridge" listed and enabled
Having trouble? Make sure you've reloaded the window after installing the extension. Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows), type "Reload Window" and select it.

Step 2: Get the Mobile App

2

Get the App on Your Phone

CRSR Mobile is currently in beta testing. Join our waitlist to get early access.

iPhone / iPad

iOS 15.0 or later

iOS beta is currently in limited testing. Join the waitlist for access.

Android

Android 10 or later

Android version coming soon. Join the waitlist for updates.

After Installing the App

  1. 1.Open the CRSR Mobile app
  2. 2.Tap "Sign In" and log in with the same account you use on this website
  3. 3.When prompted, allow push notifications - this lets you get notified when tasks complete
  4. 4.You'll see a screen asking you to pair with your desktop - keep the app open for the next step
Important: Make sure to enable push notifications when the app asks. Push notifications are generic and don't contain message content.

Step 3: Connect Your Devices

3

Log In to Connect

Your devices connect automatically when you log in with the same account. No pairing codes needed!

On Your Computer (in Cursor IDE)

  1. 1.
    Open the Command Palette:
    • • Mac: Cmd + Shift + P
    • • Windows/Linux: Ctrl + Shift + P
  2. 2.Type Cursor Mobile and select "Cursor </> Mobile: Connect to Mobile"
  3. 3.Log in with your CRSR Mobile account (the same account you created on this website)
  4. 4.Once logged in, the extension will automatically connect to the server

On Your Phone (in the CRSR Mobile App)

  1. 1.Open the CRSR Mobile app
  2. 2.Log in with the same account you used on this website and in the extension
  3. 3.The app will automatically connect to your Cursor session
  4. 4.You should see a "Connected" status once both devices are online
That's It!

As long as both devices are logged into the same account, they'll automatically find each other and connect. Your devices will appear in the Dashboard.

Not connecting? Make sure both devices are logged into the same CRSR Mobile account and that Cursor is running on your computer.

Step 4: Start Using CRSR Mobile

4

You're All Set!

Your devices are now connected. Here's how to use CRSR Mobile.

Sending Messages to Claude

  1. 1.In the mobile app, you'll see a chat interface
  2. 2.Type your message or coding request in the text field at the bottom
  3. 3.Tap the send button
  4. 4.Your message will be sent to Claude in your Cursor IDE session
  5. 5.Watch as Claude's response streams back to your phone in real-time

Quick Actions

When Claude asks for confirmation (like running a command or making changes), you can quickly respond:

/yes

Approve the pending action

/no

Decline the pending action

Checking Conversation History

Want to see what was happening in your Claude session? Type:

history

This fetches the last 10 messages from your desktop Claude Code conversation, so you can catch up on what you were working on.

Setup Complete!

You can now send messages to Claude, approve actions, and control your coding session from anywhere. Your computer just needs to stay on with Cursor running.

Chat Commands

When using the CRSR Mobile app, you can send special commands from the chat interface. These commands are handled locally and give you quick access to useful features.

history

Fetches the last messages from your current Claude Code conversation and displays them in the mobile chat. Useful for catching up on what Claude was working on before you connected.

Example:Type history → Shows your recent conversation with Claude
testflightDeveloper

Builds and uploads a new version of the mobile app to TestFlight for testing. This command is primarily for developers managing the app.

testflightPatch version (1.0.0 → 1.0.1)
testflight --minorMinor version (1.0.0 → 1.1.0)
testflight --majorMajor version (1.0.0 → 2.0.0)
This command runs the build process on your Mac (where Cursor is running) and can take 5-10 minutes. You'll see real-time status updates in the chat.
Regular Messages

Any text that isn't a special command gets sent directly to Claude Code as a prompt. Just type naturally and Claude will respond.

> Add a dark mode toggle to the settings screen

Claude: I'll help you add a dark mode toggle...

Tips

  • •Commands are not case-sensitive — history, HISTORY, and History all work
  • •You must be connected to a Cursor device to use commands
  • •Long-running commands show real-time progress in the chat

What You Can Do

Chat with Claude

Send messages and prompts to Claude from your phone. Ask questions, request code changes, or start new tasks - all from the couch, a coffee shop, or anywhere else.

Run Terminal Commands

Execute terminal commands remotely through Claude. Start builds, run tests, deploy code, or manage git operations without being at your desk.

Real-time Sync

See Claude's responses stream to your phone in real-time as they're generated. It's just like being at your computer, but portable.

Push Notifications

Get notified when Claude completes a task or needs your attention. Close the app and go about your day - you'll be alerted when something needs you.

Troubleshooting

Frequently Asked Questions

Still Need Help?

Can't find what you're looking for? Check out our Help Center or create a support ticket.