mirror of https://github.com/jackwener/OpenCLI.git synced 2026-09-14 18:25:42 +08:00

Files

T

jakevin c42b040af4 Rename chatgpt adapters: desktop → chatgpt-app, web → chatgpt (#989 )

* Rename chatgpt adapters: desktop → chatgpt-app, web → chatgpt

Aligns with existing `-app` suffix convention (discord-app, doubao-app):
- clis/chatgpt/ (desktop, AppleScript) → clis/chatgpt-app/
- clis/chatgptweb/ (browser, chatgpt.com) → clis/chatgpt/
- electron-apps.ts: chatgpt → chatgpt-app
- Updated all docs and README references

Closes #283

* Fix review findings: update cli-manifest.json and skill docs

- cli-manifest.json: update site/modulePath/sourceFile from chatgpt to chatgpt-app
- skills/opencli-usage/desktop.md: update commands from chatgpt to chatgpt-app

2026-04-13 14:33:32 +08:00

2.4 KiB

Raw Permalink Blame History

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

Install the official ChatGPT Desktop App from OpenAI.
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:

/Applications/ChatGPT.app/Contents/MacOS/ChatGPT \
  --remote-debugging-port=9224

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

2.4 KiB Raw Permalink Blame History