JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 38
  • Score
    100M100P100Q86017F
  • License SEE LICENSE IN LICENSE

CLI bridge between Codex AI (iOS) and cursor-agent with Cursor Desktop SQLite sync

Package Exports

  • cursor-mobile-bridge
  • cursor-mobile-bridge/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (cursor-mobile-bridge) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Cursor Mobile Bridge

Codex AI

The CLI bridge that connects Codex AI (iOS) to your Cursor IDE on macOS, Linux, and Windows.

Control your Cursor AI coding sessions from your iPhone — send prompts, receive AI replies, and stay synced with your workspace from anywhere.

Quick Start

npm install -g cursor-mobile-bridge
cursor-mobile-bridge --path /path/to/your/project

How It Works

The bridge connects three layers:

  1. Codex AI iOS app → sends prompts via Supabase
  2. cursor-mobile-bridge (this package) → receives prompts, runs cursor-agent CLI, mirrors replies
  3. Cursor Desktop SQLite → full chat history sync with your local IDE

Usage

cursor-mobile-bridge --path /path/to/project

Options

Flag Description Default
-p, --path <dir> Project directory for cursor-agent Current directory
--port <number> Pairing callback server port 38473
--cursor-db <path> Override Cursor Desktop state.vscdb path Auto-detected
--install Install macOS LaunchAgent (start on login) —
--uninstall Remove macOS LaunchAgent —

Pairing

  1. Install the Codex AI iOS app
  2. Run cursor-mobile-bridge --path /your/project
  3. Open the pairing link on your Mac to connect

The bridge listens on http://127.0.0.1:38473/callback for the pairing token, which is saved in ~/.cursor-mobile-bridge/config.json.

Local State

Runtime state is stored in ~/.cursor-mobile-bridge/:

  • config.json — linked user token, project path
  • state.json — session mappings, composer IDs, SQLite watermarks

Requirements

  • Node.js ≥ 18
  • Cursor Desktop with cursor-agent CLI installed
  • Codex AI iOS app (App Store)

License

Proprietary — see LICENSE for details.

© 2026 Ulad Luch. All rights reserved.