Skip to content

Run Cursor CLI on Your Phone (iPhone + Android)

cursor-agent is already installed in a cloud terminal. Run it, sign in from the browser, save a shortcut.

Updated 4 min read Cosyra team

Cursor Agent start screen in a Cosyra terminal on a phone, asking to press any key to log in
Cursor CLI Signing in screen on a phone with a cursor.com login link
Cosyra Terminals screen with a Cursor CLI shortcut at the start of the Your shortcuts row

The Cursor CLI runs on your phone through Cosyra for iPhone or Cosyra for Android. The CLI runs in a cloud Linux workspace, where cursor-agent is already installed. Your phone is the terminal.

Cursor has no shortcut card of its own yet, so you start it from a terminal and then save your own shortcut. The screenshots are from the Cosyra 2.8.5 iPhone app, taken in October 2026. The flow is the same on Android.

What you need

Run the Cursor CLI on a mobile device

Step 1

Open a new terminal in Cosyra

On Terminals, tap New and choose New terminal. The workspace wakes up and you get a shell in your home folder.

Cosyra Terminals screen with the New button pressed, offering New terminal and Open folder

Step 2

Run cursor-agent

Tap the terminal, type the command and press return:

cursor-agent

There is nothing to install first. The shorter agent starts the same program.

cursor-agent typed at the shell prompt in a Cosyra terminal

Step 3

Press a key to log in

Cursor Agent shows its version and waits. Press any key to start the login.

Cursor Agent showing its version and Press any key to log in

Step 4

Open the sign-in link

The CLI cannot open a browser from the cloud, so it prints a link. Tap it. Sign in to Cursor in your phone's browser and approve the login.

Switch back to Cosyra. The CLI notices the login by itself and opens its prompt. There is no code to copy.

Cursor CLI Signing in: if your browser didn't open, click this link to log in

Step 5

Save it as a shortcut

Go back to Terminals and tap the plus next to Your shortcuts. Fill in the sheet:

  • Name: Cursor CLI
  • Folder: your home folder, or tap Browse to pick a project
  • Command: cursor-agent

Tap Save. The card appears at the start of the row. One tap now opens a terminal in that folder and starts the Cursor CLI.

Cosyra Add shortcut sheet with Name set to Cursor CLI and Command set to cursor-agent
Cosyra Terminals screen with Cursor CLI as the first card in Your shortcuts
The saved shortcut sits first in the row.

Using the Cursor CLI from a phone

Start it inside a repository so it has code to work on. Clone the project, change into it and run the CLI: 

git clone https://github.com/you/your-repo.git
cd your-repo
cursor-agent

Then describe the change in plain words. The agent reads the files, proposes edits and asks before it runs commands.

For a one-off answer without the interactive screen, pass the prompt with -p: 

cursor-agent -p "summarize what changed in the last five commits"

Cosyra's toolbar above the keyboard adds Esc, Tab, Ctrl, Alt and the arrow keys, which the CLI's menus need. The docs list every toolbar key. The terminal lives in the workspace, so a task carries on when you lock the phone.

Questions

Can you run the Cursor CLI on a phone?

Not on the phone itself. The Cursor CLI is built for macOS and Linux. Cosyra gives your phone a cloud Linux workspace where cursor-agent is already installed, and you run it from the app's terminal.

Is the command cursor-agent or agent?

Both are in the workspace. Cursor's current docs use agent, and cursor-agent is the older name. This guide types cursor-agent because it is harder to confuse with anything else.

Do I need to install the Cursor CLI?

No. It ships in the Cosyra workspace. If the command is not found, your workspace is on an older image: run Cursor's installer once with curl https://cursor.com/install -fsS | bash.

What Cursor plan do I need?

The Cursor CLI signs in with your Cursor account and uses that account's plan and limits. For scripts you can set CURSOR_API_KEY instead of signing in.

Does it work on both iPhone and Android?

Yes. The CLI runs in the cloud workspace, so the steps are the same from either app.

What does it cost?

Cosyra is a subscription: Core is $20 a month and Pro is $30 a month. Eligible new users can start a 7-day free trial in the App Store app. Cursor usage is separate and comes from your Cursor plan.