Skip to content

Cursor IDE Beta

Prerequisites

  1. Node.js 18+
  2. Cursor IDE - cursor.com

Install & Run

bash
# Install daemon
npm install -g @cmdctrl/cursor-ide

# Register
cmdctrl-cursor-ide register -s https://api.cmd-ctrl.ai

# Quit Cursor if running, then launch with debugging flag
/Applications/Cursor.app/Contents/MacOS/Cursor --remote-debugging-port=9222 &

# Start the daemon
cmdctrl-cursor-ide start

Important

  • You must launch Cursor with a special debugging flag (--remote-debugging-port=9222) in order for Cmd+Ctrl to connect to it.
  • If Cursor is already running without this flag, the Cmd+Ctrl daemon cannot connect to it.

Auto-Launch Cursor with Debugging

macOS: Add to your shell profile:

bash
alias cursor='/Applications/Cursor.app/Contents/MacOS/Cursor --remote-debugging-port=9222'

Linux: Create an alias or modify your desktop shortcut.

Troubleshooting

"Cannot connect to Cursor" - Ensure Cursor is running with --remote-debugging-port=9222

"Connection refused on 9222" - Restart Cursor with the debugging flag

Port conflict - Pick another port and set CDP_PORT env var