9b395f5cc3
E2E Headed Chrome / e2e-headed (macos-15) (push) Has been cancelled
E2E Headed Chrome / e2e-headed (ubuntu-latest) (push) Has been cancelled
E2E Headed Chrome / e2e-headed (windows-latest) (push) Has been cancelled
CI / build (macos-latest) (push) Has been cancelled
CI / build (ubuntu-latest) (push) Has been cancelled
CI / build (windows-latest) (push) Has been cancelled
CI / unit-test (push) Has been cancelled
CI / bun-test (push) Has been cancelled
CI / adapter-test (push) Has been cancelled
CI / smoke-test (macos-latest) (push) Has been cancelled
CI / smoke-test (ubuntu-latest) (push) Has been cancelled
Security Audit / audit (push) Has been cancelled
Build Chrome Extension / build (push) Has been cancelled
Trigger Website Rebuild (Docs Updated) / dispatch (push) Has been cancelled
38 lines
1.6 KiB
Markdown
38 lines
1.6 KiB
Markdown
# Cursor
|
|
|
|
Control the **Cursor IDE** from the terminal via Chrome DevTools Protocol (CDP). Since Cursor is built on Electron (VS Code fork), OpenCLI can drive its internal UI, automate Composer interactions, and manipulate chat sessions.
|
|
|
|
## Prerequisites
|
|
|
|
1. Install [Cursor](https://cursor.sh/).
|
|
2. Launch it with the remote debugging port:
|
|
```bash
|
|
/Applications/Cursor.app/Contents/MacOS/Cursor --remote-debugging-port=9226
|
|
```
|
|
|
|
## Setup
|
|
|
|
```bash
|
|
export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9226"
|
|
```
|
|
|
|
## Commands
|
|
|
|
### Diagnostics
|
|
- `opencli cursor status`: Check CDP connection status.
|
|
- `opencli cursor dump`: Dump the full DOM and Accessibility snapshot to `/tmp/cursor-dom.html` and `/tmp/cursor-snapshot.json`.
|
|
- `opencli cursor screenshot`: Capture DOM + snapshot artifacts of the current window.
|
|
|
|
### Chat Manipulation
|
|
- `opencli cursor new`: Press `Cmd+N` to start a new file/tab.
|
|
- `opencli cursor send "message"`: Inject text into the active Composer/Chat input and submit.
|
|
- `opencli cursor ask "message"`: Send + wait + read in one shot.
|
|
- `opencli cursor read`: Extract the full conversation history from the active chat panel.
|
|
|
|
### AI Features
|
|
- `opencli cursor composer "prompt"`: Open the Composer panel (`Cmd+I`) and send a prompt for inline AI editing.
|
|
- `opencli cursor model`: Get the currently active AI model (e.g., `claude-4.5-sonnet`).
|
|
- `opencli cursor extract-code`: Extract all code blocks from the current conversation.
|
|
- `opencli cursor history`: List recent chat/composer sessions from the sidebar.
|
|
- `opencli cursor export`: Export the current conversation as Markdown.
|