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

jackwener · web-flow · commit c42b040af4fc · 2026-04-13T14:33:32.000+08:00
* 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
diff --git a/README.md b/README.md
@@ -246,7 +246,7 @@ Control Electron desktop apps directly from the terminal. Each adapter has its o
 | **Cursor** | Control Cursor IDE — Composer, chat, code extraction | [Doc](./docs/adapters/desktop/cursor.md) |
 | **Codex** | Drive OpenAI Codex CLI agent headlessly | [Doc](./docs/adapters/desktop/codex.md) |
 | **Antigravity** | Control Antigravity Ultra from terminal | [Doc](./docs/adapters/desktop/antigravity.md) |
-| **ChatGPT** | Automate ChatGPT macOS desktop app | [Doc](./docs/adapters/desktop/chatgpt.md) |
+| **ChatGPT App** | Automate ChatGPT macOS desktop app | [Doc](./docs/adapters/desktop/chatgpt-app.md) |
 | **ChatWise** | Multi-LLM client (GPT-4, Claude, Gemini) | [Doc](./docs/adapters/desktop/chatwise.md) |
 | **Notion** | Search, read, write Notion pages | [Doc](./docs/adapters/desktop/notion.md) |
 | **Discord** | Discord Desktop — messages, channels, servers | [Doc](./docs/adapters/desktop/discord.md) |
diff --git a/README.zh-CN.md b/README.zh-CN.md
@@ -202,7 +202,7 @@ npm link
 | **v2ex** | `hot` `latest` `topic` `node` `user` `member` `replies` `nodes` `daily` `me` `notifications` | 公开 / 浏览器 |
 | **xueqiu** | `feed` `hot-stock` `hot` `search` `stock` `comments` `watchlist` `earnings-date` `fund-holdings` `fund-snapshot` | 浏览器 |
 | **antigravity** | `status` `send` `read` `new` `dump` `extract-code` `model` `watch` | 桌面端 |
-| **chatgpt** | `status` `new` `send` `read` `ask` `model` | 桌面端 |
+| **chatgpt-app** | `status` `new` `send` `read` `ask` `model` | 桌面端 |
 | **xiaohongshu** | `search` `notifications` `feed` `user` `download` `publish` `creator-notes` `creator-note-detail` `creator-notes-summary` `creator-profile` `creator-stats` | 浏览器 |
 | **xiaoe** | `courses` `detail` `catalog` `play-url` `content` | 浏览器 |
 | **quark** | `ls` `mkdir` `mv` `rename` `rm` `save` `share-tree` | 浏览器 |
@@ -300,7 +300,7 @@ opencli register mycli
 | **Cursor** | 控制 Cursor IDE — Composer、对话、代码提取等 | [Doc](./docs/adapters/desktop/cursor.md) |
 | **Codex** | 在后台（无头）驱动 OpenAI Codex CLI Agent | [Doc](./docs/adapters/desktop/codex.md) |
 | **Antigravity** | 在终端直接控制 Antigravity Ultra | [Doc](./docs/adapters/desktop/antigravity.md) |
-| **ChatGPT** | 自动化操作 ChatGPT macOS 桌面客户端 | [Doc](./docs/adapters/desktop/chatgpt.md) |
+| **ChatGPT App** | 自动化操作 ChatGPT macOS 桌面客户端 | [Doc](./docs/adapters/desktop/chatgpt-app.md) |
 | **ChatWise** | 多 LLM 客户端（GPT-4、Claude、Gemini） | [Doc](./docs/adapters/desktop/chatwise.md) |
 | **Notion** | 搜索、读取、写入 Notion 页面 | [Doc](./docs/adapters/desktop/notion.md) |
 | **Discord** | Discord 桌面版 — 消息、频道、服务器 | [Doc](./docs/adapters/desktop/discord.md) |
diff --git a/cli-manifest.json b/cli-manifest.json
@@ -2779,7 +2779,7 @@
     "sourceFile": "chaoxing/exams.js"
   },
   {
-    "site": "chatgpt",
+    "site": "chatgpt-app",
     "name": "ask",
     "description": "Send a prompt and wait for the AI response (send + wait + read)",
     "domain": "localhost",
@@ -2819,11 +2819,11 @@
       "Text"
     ],
     "type": "js",
-    "modulePath": "chatgpt/ask.js",
-    "sourceFile": "chatgpt/ask.js"
+    "modulePath": "chatgpt-app/ask.js",
+    "sourceFile": "chatgpt-app/ask.js"
   },
   {
-    "site": "chatgpt",
+    "site": "chatgpt-app",
     "name": "model",
     "description": "Switch ChatGPT Desktop model/mode (auto, instant, thinking, 5.2-instant, 5.2-thinking)",
     "domain": "localhost",
@@ -2850,11 +2850,11 @@
       "Model"
     ],
     "type": "js",
-    "modulePath": "chatgpt/model.js",
-    "sourceFile": "chatgpt/model.js"
+    "modulePath": "chatgpt-app/model.js",
+    "sourceFile": "chatgpt-app/model.js"
   },
   {
-    "site": "chatgpt",
+    "site": "chatgpt-app",
     "name": "new",
     "description": "Open a new chat in ChatGPT Desktop App",
     "domain": "localhost",
@@ -2865,11 +2865,11 @@
       "Status"
     ],
     "type": "js",
-    "modulePath": "chatgpt/new.js",
-    "sourceFile": "chatgpt/new.js"
+    "modulePath": "chatgpt-app/new.js",
+    "sourceFile": "chatgpt-app/new.js"
   },
   {
-    "site": "chatgpt",
+    "site": "chatgpt-app",
     "name": "read",
     "description": "Read the last visible message from the focused ChatGPT Desktop window",
     "domain": "localhost",
@@ -2881,11 +2881,11 @@
       "Text"
     ],
     "type": "js",
-    "modulePath": "chatgpt/read.js",
-    "sourceFile": "chatgpt/read.js"
+    "modulePath": "chatgpt-app/read.js",
+    "sourceFile": "chatgpt-app/read.js"
   },
   {
-    "site": "chatgpt",
+    "site": "chatgpt-app",
     "name": "send",
     "description": "Send a message to the active ChatGPT Desktop App window",
     "domain": "localhost",
@@ -2917,11 +2917,11 @@
       "Status"
     ],
     "type": "js",
-    "modulePath": "chatgpt/send.js",
-    "sourceFile": "chatgpt/send.js"
+    "modulePath": "chatgpt-app/send.js",
+    "sourceFile": "chatgpt-app/send.js"
   },
   {
-    "site": "chatgpt",
+    "site": "chatgpt-app",
     "name": "status",
     "description": "Check if ChatGPT Desktop App is running natively on macOS",
     "domain": "localhost",
@@ -2932,8 +2932,8 @@
       "Status"
     ],
     "type": "js",
-    "modulePath": "chatgpt/status.js",
-    "sourceFile": "chatgpt/status.js"
+    "modulePath": "chatgpt-app/status.js",
+    "sourceFile": "chatgpt-app/status.js"
   },
   {
     "site": "chatwise",
diff --git a/clis/chatgpt-app/ask.js b/clis/chatgpt-app/ask.js
@@ -3,7 +3,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 import { ConfigError } from '@jackwener/opencli/errors';
 import { activateChatGPT, getVisibleChatMessages, selectModel, MODEL_CHOICES, isGenerating } from './ax.js';
 export const askCommand = cli({
-    site: 'chatgpt',
+    site: 'chatgpt-app',
     name: 'ask',
     description: 'Send a prompt and wait for the AI response (send + wait + read)',
     domain: 'localhost',
diff --git a/clis/chatgpt-app/ax.js b/clis/chatgpt-app/ax.js
diff --git a/clis/chatgpt-app/model.js b/clis/chatgpt-app/model.js
@@ -2,7 +2,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 import { ConfigError } from '@jackwener/opencli/errors';
 import { activateChatGPT, selectModel, MODEL_CHOICES } from './ax.js';
 export const modelCommand = cli({
-    site: 'chatgpt',
+    site: 'chatgpt-app',
     name: 'model',
     description: 'Switch ChatGPT Desktop model/mode (auto, instant, thinking, 5.2-instant, 5.2-thinking)',
     domain: 'localhost',
diff --git a/clis/chatgpt-app/new.js b/clis/chatgpt-app/new.js
@@ -2,7 +2,7 @@ import { execSync } from 'node:child_process';
 import { cli, Strategy } from '@jackwener/opencli/registry';
 import { ConfigError, getErrorMessage } from '@jackwener/opencli/errors';
 export const newCommand = cli({
-    site: 'chatgpt',
+    site: 'chatgpt-app',
     name: 'new',
     description: 'Open a new chat in ChatGPT Desktop App',
     domain: 'localhost',
diff --git a/clis/chatgpt-app/read.js b/clis/chatgpt-app/read.js
@@ -3,7 +3,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 import { CommandExecutionError, ConfigError, getErrorMessage } from '@jackwener/opencli/errors';
 import { getVisibleChatMessages } from './ax.js';
 export const readCommand = cli({
-    site: 'chatgpt',
+    site: 'chatgpt-app',
     name: 'read',
     description: 'Read the last visible message from the focused ChatGPT Desktop window',
     domain: 'localhost',
diff --git a/clis/chatgpt-app/send.js b/clis/chatgpt-app/send.js
@@ -3,7 +3,7 @@ import { cli, Strategy } from '@jackwener/opencli/registry';
 import { getErrorMessage } from '@jackwener/opencli/errors';
 import { activateChatGPT, selectModel, MODEL_CHOICES } from './ax.js';
 export const sendCommand = cli({
-    site: 'chatgpt',
+    site: 'chatgpt-app',
     name: 'send',
     description: 'Send a message to the active ChatGPT Desktop App window',
     domain: 'localhost',
diff --git a/clis/chatgpt-app/status.js b/clis/chatgpt-app/status.js
@@ -2,7 +2,7 @@ import { execSync } from 'node:child_process';
 import { cli, Strategy } from '@jackwener/opencli/registry';
 import { CommandExecutionError, ConfigError } from '@jackwener/opencli/errors';
 export const statusCommand = cli({
-    site: 'chatgpt',
+    site: 'chatgpt-app',
     name: 'status',
     description: 'Check if ChatGPT Desktop App is running natively on macOS',
     domain: 'localhost',
diff --git a/clis/chatgpt/image.js b/clis/chatgpt/image.js
@@ -30,7 +30,7 @@ async function currentChatGPTLink(page) {
 }
 
 export const imageCommand = cli({
-    site: 'chatgptweb',
+    site: 'chatgpt',
     name: 'image',
     description: 'Generate images with ChatGPT web and save them locally',
     domain: CHATGPT_DOMAIN,
diff --git a/clis/chatgpt/utils.js b/clis/chatgpt/utils.js
diff --git a/docs/adapters/browser/chatgpt.md b/docs/adapters/browser/chatgpt.md
@@ -6,19 +6,19 @@
 
 | Command | Description |
 |---------|-------------|
-| `opencli chatgptweb image <prompt>` | Generate images in ChatGPT web and optionally save them locally |
+| `opencli chatgpt image <prompt>` | Generate images in ChatGPT web and optionally save them locally |
 
 ## Usage Examples
 
 ```bash
 # Generate an image and save it to the default directory
-opencli chatgptweb image "a cyberpunk city at night"
+opencli chatgpt image "a cyberpunk city at night"
 
 # Save to a custom output directory
-opencli chatgptweb image "a robot sketching on paper" --op ~/Downloads/chatgpt-images
+opencli chatgpt image "a robot sketching on paper" --op ~/Downloads/chatgpt-images
 
 # Only generate in ChatGPT and print the conversation link
-opencli chatgptweb image "a tiny watercolor fox" --sd true
+opencli chatgpt image "a tiny watercolor fox" --sd true
 ```
 
 ## Options
diff --git a/docs/adapters/desktop/chatgpt-app.md b/docs/adapters/desktop/chatgpt-app.md
@@ -1,4 +1,4 @@
-# ChatGPT
+# ChatGPT App
 
 Control the **ChatGPT macOS Desktop App** directly from the terminal. OpenCLI supports two automation approaches for ChatGPT.
 
@@ -11,14 +11,14 @@ The current built-in commands use native AppleScript automation — no extra lau
 2. Grant **Accessibility permissions** to your terminal app in **System Settings → Privacy & Security → Accessibility**.
 
 ### Commands
-- `opencli chatgpt status`: Check if the ChatGPT app is currently running.
-- `opencli chatgpt new`: Activate ChatGPT and press `Cmd+N` to start a new conversation.
-- `opencli chatgpt send "message"`: Copy your message to clipboard, activate ChatGPT, paste, and submit.
-- `opencli chatgpt send "message" --model thinking`: Switch model/mode first, then send the message.
-- `opencli chatgpt read`: Read the last visible message from the focused ChatGPT window via the Accessibility tree.
-- `opencli chatgpt ask "message"`: Send a prompt and wait for the visible reply in one shot.
-- `opencli chatgpt ask "message" --model instant`: Run a one-shot prompt using a specific model/mode.
-- `opencli chatgpt model thinking`: Switch the active ChatGPT model/mode without sending a message.
+- `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`.
 
diff --git a/docs/adapters/index.md b/docs/adapters/index.md
@@ -95,7 +95,7 @@ Run `opencli list` for the live registry.
 | **[Cursor](./desktop/cursor.md)**           | Control Cursor IDE            | `status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export` |
 | **[Codex](./desktop/codex.md)**             | Drive OpenAI Codex CLI agent  | `status` `send` `read` `new` `extract-diff` `model` `ask` `screenshot` `history` `export`                   |
 | **[Antigravity](./desktop/antigravity.md)** | Control Antigravity Ultra     | `status` `send` `read` `new` `dump` `extract-code` `model` `watch`                                          |
-| **[ChatGPT](./desktop/chatgpt.md)**         | Automate ChatGPT macOS app    | `status` `new` `send` `read` `ask` `model`                                                                  |
+| **[ChatGPT App](./desktop/chatgpt-app.md)** | Automate ChatGPT macOS app    | `status` `new` `send` `read` `ask` `model`                                                                  |
 | **[ChatWise](./desktop/chatwise.md)**       | Multi-LLM client              | `status` `new` `send` `read` `ask` `model` `history` `export` `screenshot`                                  |
 | **[Notion](./desktop/notion.md)**           | Search, read, write pages     | `status` `search` `read` `new` `write` `sidebar` `favorites` `export`                                       |
 | **[Discord](./desktop/discord.md)**         | Desktop messages & channels   | `status` `send` `read` `channels` `servers` `search` `members`                                              |
diff --git a/skills/opencli-usage/desktop.md b/skills/opencli-usage/desktop.md
@@ -29,15 +29,15 @@ opencli codex model [model-name]         # 查看或切换当前 AI 模型
 opencli codex send "message"             # 发送文本/命令到 Codex
 ```
 
-## ChatGPT (desktop — macOS AppleScript/CDP)
+## ChatGPT App (desktop — macOS AppleScript/CDP)
 
 ```bash
-opencli chatgpt status                   # 检查应用状态
-opencli chatgpt ask "question"           # 一键提问并等回复 (send + wait + read)
-opencli chatgpt model <model>            # 切换模型/模式 (auto, instant, thinking 等)
-opencli chatgpt read                     # 读取最近一条可见消息
-opencli chatgpt new                      # 新建对话
-opencli chatgpt send "message"           # 发送消息
+opencli chatgpt-app status                   # 检查应用状态
+opencli chatgpt-app ask "question"           # 一键提问并等回复 (send + wait + read)
+opencli chatgpt-app model <model>            # 切换模型/模式 (auto, instant, thinking 等)
+opencli chatgpt-app read                     # 读取最近一条可见消息
+opencli chatgpt-app new                      # 新建对话
+opencli chatgpt-app send "message"           # 发送消息
 ```
 
 ## ChatWise (desktop — multi-LLM client)
diff --git a/src/electron-apps.ts b/src/electron-apps.ts
@@ -39,7 +39,7 @@ export const builtinApps: Record<string, ElectronAppEntry> = {
     bundleId: 'dev.antigravity.app',
     displayName: 'Antigravity',
   },
-  chatgpt:       { port: 9236, processName: 'ChatGPT',      bundleId: 'com.openai.chat',                displayName: 'ChatGPT' },
+  'chatgpt-app': { port: 9236, processName: 'ChatGPT',      bundleId: 'com.openai.chat',                displayName: 'ChatGPT' },
 };
 
 /** Merge builtin + user-defined apps. User entries are additive only. */
