wehub-resource-sync
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
50 lines
2.4 KiB
Markdown
50 lines
2.4 KiB
Markdown
# ChatGPT App
|
|
|
|
Control the **ChatGPT macOS Desktop App** directly from the terminal. OpenCLI supports two automation approaches for ChatGPT.
|
|
|
|
## Approach 1: AppleScript (Default, No Setup)
|
|
|
|
The current built-in commands use native AppleScript automation — no extra launch flags needed.
|
|
|
|
### Prerequisites
|
|
1. Install the official [ChatGPT Desktop App](https://openai.com/chatgpt/mac/) from OpenAI.
|
|
2. Grant **Accessibility permissions** to your terminal app in **System Settings → Privacy & Security → Accessibility**.
|
|
|
|
### Commands
|
|
- `opencli chatgpt-app status`: Check if the ChatGPT app is currently running.
|
|
- `opencli chatgpt-app new`: Activate ChatGPT and press `Cmd+N` to start a new conversation.
|
|
- `opencli chatgpt-app send "message"`: Copy your message to clipboard, activate ChatGPT, paste, and submit.
|
|
- `opencli chatgpt-app send "message" --model thinking`: Switch model/mode first, then send the message.
|
|
- `opencli chatgpt-app read`: Read the last visible message from the focused ChatGPT window via the Accessibility tree.
|
|
- `opencli chatgpt-app ask "message"`: Send a prompt and wait for the visible reply in one shot.
|
|
- `opencli chatgpt-app ask "message" --model instant`: Run a one-shot prompt using a specific model/mode.
|
|
- `opencli chatgpt-app model thinking`: Switch the active ChatGPT model/mode without sending a message.
|
|
|
|
Supported model choices: `auto`, `instant`, `thinking`, `5.2-instant`, `5.2-thinking`.
|
|
|
|
## Approach 2: CDP (Advanced, Electron Debug Mode)
|
|
|
|
ChatGPT Desktop is also an Electron app and can be launched with a remote debugging port:
|
|
|
|
```bash
|
|
/Applications/ChatGPT.app/Contents/MacOS/ChatGPT \
|
|
--remote-debugging-port=9224
|
|
```
|
|
|
|
```bash
|
|
export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9224"
|
|
```
|
|
|
|
> The CDP approach is primarily for advanced automation and future desktop-only commands. The built-in command set above still works in the default AppleScript path unless you explicitly route through `OPENCLI_CDP_ENDPOINT`.
|
|
|
|
## How It Works
|
|
|
|
- **AppleScript mode**: Uses `osascript` to control ChatGPT, `pbcopy`/`pbpaste` to paste prompts, and the macOS Accessibility tree to read visible chat messages.
|
|
- **CDP mode**: Connects via Chrome DevTools Protocol to the Electron renderer process.
|
|
|
|
## Limitations
|
|
|
|
- macOS only (AppleScript dependency)
|
|
- AppleScript mode requires Accessibility permissions
|
|
- `read` returns the last visible message in the focused ChatGPT window — scroll first if the message you want is not visible
|