cursor-cdp-control

name

cursor-cdp-control

description

Control Cursor IDE via opencli + CDP from the terminal. Send prompts, read chat, switch models, browse history, take screenshots, create new agents, switch projects. Auto-compatible with Cursor 3 Agent standalone window and traditional Editor embedded chat. Use when users need to control Cursor from the command line, send prompts, read conversations, switch models, view history, take screenshots, create new agent tabs, switch projects, or mention keywords like cursor cdp, cursor control, cursor screenshot, cursor model switch, opencli cursor.

Cursor CDP Control

Control Cursor IDE via opencli cursor commands using Chrome DevTools Protocol (CDP).

All commands auto-detect window type:

• Agent window - Cursor 3 standalone Agent window (title = "Cursor Agents")
• Editor window - Traditional editor with embedded Chat panel

Prerequisites

1. Launch Cursor with CDP port enabled

Close all Cursor instances first, then relaunch:

# Windows
"C:\Program Files\cursor\Cursor.exe" --remote-debugging-port=9226

# macOS
/Applications/Cursor.app/Contents/MacOS/Cursor --remote-debugging-port=9226

Notes:

• Must close all Cursor windows before launching (Electron single-instance lock)
• Default port is 9226; customize with --port argument
• Do not use the cursor CLI tool (it invokes cli.js, not the GUI)

2. Install plugin dependencies

cd ~/.opencli/plugins/ksh-plugin-cursor && npm install

3. Verify connection

opencli cursor status

Command Reference

Command	Description	Example
cursor status	CDP connection status	opencli cursor status
cursor list	List all windows (Agent/Editor)	opencli cursor list
cursor new-chat	Open a new Agent/Chat tab	opencli cursor new-chat
cursor project	List available projects (Agent only)	opencli cursor project
cursor project-switch	Switch project by fuzzy match (Agent only)	opencli cursor project-switch "llm-wiki"
cursor send	Send prompt and wait for reply	opencli cursor send "refactor this code"
cursor read	Read current Chat content	opencli cursor read --limit 10
cursor history	Browse chat history sessions	opencli cursor history "test"
cursor model	List available models	opencli cursor model
cursor model-switch	Switch model by fuzzy match	opencli cursor model-switch "sonnet"
cursor screenshot	Capture screenshot	opencli cursor screenshot chat

See references/commands.md for detailed parameters.

Window Type Differences

All commands auto-detect, no manual specification needed:

Component	Agent Window	Editor Window
Input box	TipTap ProseMirror	aislash-editor
History	Sidebar, grouped by project, always visible	Click button to show popup panel
Chat area	.agent-panel	composer container
Model picker	Shared .ui-model-picker__trigger	Shared
Project picker	Supported (.ui-select-trigger)	Not supported

Use --window N to target a specific window (N matches cursor list idx, 1-based). Default 0 auto-selects Agent window.

Typical Usage

# List all windows
opencli cursor list

# Open a new Agent tab
opencli cursor new-chat

# Send to a specific project (auto-finds window by project name, works in both Agent & Editor)
opencli cursor send "analyze this code" --project "mcd"

# Switch project in Agent window (Agent only)
opencli cursor project-switch "llm-wiki"

# Send a prompt (auto-selects Agent window)
opencli cursor send "analyze this code"

# Browse Editor window history
opencli cursor history "refactor" --window 3

# Switch model and take screenshot
opencli cursor model-switch "sonnet"
opencli cursor screenshot chat

Technical Details

Uses CDP HTTP API to discover window targets, then communicates via WebSocket:

• Runtime.evaluate - DOM queries and data extraction
• Input.insertText / Input.dispatchMouseEvent / Input.dispatchKeyEvent - Simulated user interaction
• Page.captureScreenshot - Headless screenshot to file

Auto-detects window type by target title, applies type-specific DOM selectors. Non-invasive, no native hooks.