fix(electron-apps): move codex CDP port off 9222 to avoid browser-bridge collision

docs/adapters/desktop/codex.md

@@ -8,13 +8,13 @@ Control the **OpenAI Codex Desktop App** headless or headfully via Chrome DevToo
 2. Launch it via the terminal and expose the remote debugging port:
    ```bash
    # macOS
-   /Applications/Codex.app/Contents/MacOS/Codex --remote-debugging-port=9222
+   /Applications/Codex.app/Contents/MacOS/Codex --remote-debugging-port=9238
    ```
 
 ## Setup
 
 ```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9222"
+export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9238"
 ```
 
 ## Commands

docs/advanced/electron.md

@@ -14,7 +14,7 @@ Electron apps are essentially local Chromium browser instances. By exposing a de
 
 ### Launching the Target App
 ```bash
-/Applications/AppName.app/Contents/MacOS/AppName --remote-debugging-port=9222
+/Applications/AppName.app/Contents/MacOS/AppName --remote-debugging-port=<unique-port>
 ```
 
 ### Verifying Electron
@@ -82,7 +82,7 @@ await page.wait(1); // Wait for re-render
 
 ## Environment Variable
 ```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9222"
+export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:<unique-port>"
 ```
 
 ## Non-Electron Pattern (AppleScript)
@@ -108,7 +108,7 @@ Core techniques:
 
 ## Pitfalls & Gotchas
 
-1. **Port conflicts (EADDRINUSE)**: Only one app per port. Use unique ports: Codex=9222, ChatGPT=9224, Cursor=9226, ChatWise=9228, Discord=9232
+1. **Port conflicts (EADDRINUSE)**: Only one app per port. Use unique ports matching the builtin registry: Codex=9238, Doubao=9225, Cursor=9226, ChatWise=9228, Discord=9232, Antigravity=9234, ChatGPT=9236. Avoid `9222`, the default Chrome DevTools port the opencli browser bridge already binds.
 2. **IPage abstraction**: OpenCLI wraps the browser page as `IPage` (`src/types.ts`). Use `page.pressKey()` and `page.evaluate()`, NOT direct DOM APIs
 3. **Timing**: Always add `await page.wait(0.5)` to `1.0` after DOM mutations. Returning too early disconnects prematurely
 4. **AppleScript requires Accessibility**: Terminal app must be granted permission in System Settings → Privacy & Security → Accessibility
@@ -117,8 +117,10 @@ Core techniques:
 
 | App | Port | Mode |
 |-----|------|------|
-| Codex | 9222 | CDP |
-| ChatGPT | 9224 | CDP / AppleScript |
+| Codex | 9238 | CDP |
+| Doubao | 9225 | CDP |
 | Cursor | 9226 | CDP |
 | ChatWise | 9228 | CDP |
 | Discord App | 9232 | CDP |
+| Antigravity | 9234 | CDP |
+| ChatGPT | 9236 | CDP / AppleScript |

docs/guide/electron-app-cli.md

@@ -35,13 +35,13 @@ If Electron is present, the next step is usually to launch the app with a debugg
 ### 2. Launch it with CDP enabled
 
 ```bash
-/Applications/AppName.app/Contents/MacOS/AppName --remote-debugging-port=9222
+/Applications/AppName.app/Contents/MacOS/AppName --remote-debugging-port=<unique-port>
 ```
 
 Then point OpenCLI at that CDP endpoint:
 
 ```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9222"
+export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:<unique-port>"
 ```
 
 ### 3. Start with the 5-command pattern

docs/zh/guide/electron-app-cli.md

@@ -31,13 +31,13 @@ ls /Applications/AppName.app/Contents/Frameworks/Electron\ Framework.framework
 ### 2. 带 CDP 端口启动应用
 
 ```bash
-/Applications/AppName.app/Contents/MacOS/AppName --remote-debugging-port=9222
+/Applications/AppName.app/Contents/MacOS/AppName --remote-debugging-port=<unique-port>
 ```
 
 然后把 OpenCLI 指到这个端口：
 
 ```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9222"
+export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:<unique-port>"
 ```
 
 ### 3. 先做 5 个基础命令

src/electron-apps.test.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { getElectronApp, isElectronApp, loadApps } from './electron-apps.js';
+import { builtinApps, getElectronApp, isElectronApp, loadApps } from './electron-apps.js';
 
 describe('electron-apps registry', () => {
   it('returns builtin app entry for cursor', () => {
@@ -12,7 +12,14 @@ describe('electron-apps registry', () => {
   it('returns builtin app entry for codex', () => {
     const app = getElectronApp('codex');
     expect(app).toBeDefined();
-    expect(app!.port).toBe(9222);
+    expect(app!.port).toBe(9238);
+  });
+
+  it('keeps builtin Electron app CDP ports unique and off the browser-bridge port', () => {
+    const ports = Object.values(builtinApps).map((app) => app.port);
+
+    expect(new Set(ports).size).toBe(ports.length);
+    expect(ports).not.toContain(9222);
   });
 
   it('returns undefined for non-Electron sites', () => {

src/electron-apps.ts

@@ -27,7 +27,7 @@ export interface ElectronAppEntry {
 
 export const builtinApps: Record<string, ElectronAppEntry> = {
   cursor:        { port: 9226, processName: 'Cursor',      bundleId: 'com.todesktop.runtime.Cursor',   displayName: 'Cursor' },
-  codex:         { port: 9222, processName: 'Codex',        bundleId: 'com.openai.codex',               displayName: 'Codex' },
+  codex:         { port: 9238, processName: 'Codex',        bundleId: 'com.openai.codex',               displayName: 'Codex' },
   chatwise:      { port: 9228, processName: 'ChatWise',     bundleId: 'com.chatwise.app',               displayName: 'ChatWise' },
   'discord-app': { port: 9232, processName: 'Discord',      bundleId: 'com.discord.app',                 displayName: 'Discord' },
   'doubao-app':  { port: 9225, processName: 'Doubao',       bundleId: 'com.volcengine.doubao',          displayName: 'Doubao' },