@jackwener/opencli 0.9.5 → 0.9.8

package/src/build-manifest.ts

@@ -11,7 +11,7 @@
 
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 import yaml from 'js-yaml';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -43,6 +43,116 @@ interface ManifestEntry {
   modulePath?: string;
 }
 
+function extractBalancedBlock(
+  source: string,
+  startIndex: number,
+  openChar: string,
+  closeChar: string,
+): string | null {
+  let depth = 0;
+  let quote: string | null = null;
+  let escaped = false;
+
+  for (let i = startIndex; i < source.length; i++) {
+    const ch = source[i];
+
+    if (quote) {
+      if (escaped) {
+        escaped = false;
+        continue;
+      }
+      if (ch === '\\') {
+        escaped = true;
+        continue;
+      }
+      if (ch === quote) quote = null;
+      continue;
+    }
+
+    if (ch === '"' || ch === '\'' || ch === '`') {
+      quote = ch;
+      continue;
+    }
+
+    if (ch === openChar) {
+      depth++;
+    } else if (ch === closeChar) {
+      depth--;
+      if (depth === 0) {
+        return source.slice(startIndex + 1, i);
+      }
+    }
+  }
+
+  return null;
+}
+
+function extractTsArgsBlock(source: string): string | null {
+  const argsMatch = source.match(/args\s*:/);
+  if (!argsMatch || argsMatch.index === undefined) return null;
+
+  const bracketIndex = source.indexOf('[', argsMatch.index);
+  if (bracketIndex === -1) return null;
+
+  return extractBalancedBlock(source, bracketIndex, '[', ']');
+}
+
+function parseInlineChoices(body: string): string[] | undefined {
+  const choicesMatch = body.match(/choices\s*:\s*\[([^\]]*)\]/);
+  if (!choicesMatch) return undefined;
+
+  const values = choicesMatch[1]
+    .split(',')
+    .map(s => s.trim().replace(/^['"`]|['"`]$/g, ''))
+    .filter(Boolean);
+
+  return values.length > 0 ? values : undefined;
+}
+
+export function parseTsArgsBlock(argsBlock: string): ManifestEntry['args'] {
+  const args: ManifestEntry['args'] = [];
+  let cursor = 0;
+
+  while (cursor < argsBlock.length) {
+    const nameMatch = argsBlock.slice(cursor).match(/\{\s*name\s*:\s*['"`](\w+)['"`]/);
+    if (!nameMatch || nameMatch.index === undefined) break;
+
+    const objectStart = cursor + nameMatch.index;
+    const body = extractBalancedBlock(argsBlock, objectStart, '{', '}');
+    if (body == null) break;
+
+    const typeMatch = body.match(/type\s*:\s*['"`](\w+)['"`]/);
+    const defaultMatch = body.match(/default\s*:\s*([^,}]+)/);
+    const requiredMatch = body.match(/required\s*:\s*(true|false)/);
+    const helpMatch = body.match(/help\s*:\s*['"`]([^'"`]*)['"`]/);
+    const positionalMatch = body.match(/positional\s*:\s*(true|false)/);
+
+    let defaultVal: any = undefined;
+    if (defaultMatch) {
+      const raw = defaultMatch[1].trim();
+      if (raw === 'true') defaultVal = true;
+      else if (raw === 'false') defaultVal = false;
+      else if (/^\d+$/.test(raw)) defaultVal = parseInt(raw, 10);
+      else if (/^\d+\.\d+$/.test(raw)) defaultVal = parseFloat(raw);
+      else defaultVal = raw.replace(/^['"`]|['"`]$/g, '');
+    }
+
+    args.push({
+      name: nameMatch[1],
+      type: typeMatch?.[1] ?? 'str',
+      default: defaultVal,
+      required: requiredMatch?.[1] === 'true',
+      positional: positionalMatch?.[1] === 'true' || undefined,
+      help: helpMatch?.[1] ?? '',
+      choices: parseInlineChoices(body),
+    });
+
+    cursor = objectStart + body.length + 2;
+  }
+
+  return args;
+}
+
 function scanYaml(filePath: string, site: string): ManifestEntry | null {
   try {
     const raw = fs.readFileSync(filePath, 'utf-8');
@@ -129,39 +239,9 @@ function scanTs(filePath: string, site: string): ManifestEntry {
     }
 
     // Extract args array items: { name: '...', ... }
-    const argsBlockMatch = src.match(/args\s*:\s*\[([\s\S]*?)\]\s*,/);
-    if (argsBlockMatch) {
-      const argsBlock = argsBlockMatch[1];
-      const argRegex = /\{\s*name\s*:\s*['"`](\w+)['"`]([^}]*)\}/g;
-      let m;
-      while ((m = argRegex.exec(argsBlock)) !== null) {
-        const argName = m[1];
-        const body = m[2];
-        const typeMatch = body.match(/type\s*:\s*['"`](\w+)['"`]/);
-        const defaultMatch = body.match(/default\s*:\s*([^,}]+)/);
-        const requiredMatch = body.match(/required\s*:\s*(true|false)/);
-        const helpMatch = body.match(/help\s*:\s*['"`]([^'"`]*)['"`]/);
-        const positionalMatch = body.match(/positional\s*:\s*(true|false)/);
-
-        let defaultVal: any = undefined;
-        if (defaultMatch) {
-          const raw = defaultMatch[1].trim();
-          if (raw === 'true') defaultVal = true;
-          else if (raw === 'false') defaultVal = false;
-          else if (/^\d+$/.test(raw)) defaultVal = parseInt(raw, 10);
-          else if (/^\d+\.\d+$/.test(raw)) defaultVal = parseFloat(raw);
-          else defaultVal = raw.replace(/^['"`]|['"`]$/g, '');
-        }
-
-        entry.args.push({
-          name: argName,
-          type: typeMatch?.[1] ?? 'str',
-          default: defaultVal,
-          required: requiredMatch?.[1] === 'true',
-          positional: positionalMatch?.[1] === 'true' || undefined,
-          help: helpMatch?.[1] ?? '',
-        });
-      }
+    const argsBlock = extractTsArgsBlock(src);
+    if (argsBlock) {
+      entry.args = parseTsArgsBlock(argsBlock);
     }
   } catch {
     // If parsing fails, fall back to empty metadata — module will self-register at runtime
@@ -170,32 +250,42 @@ function scanTs(filePath: string, site: string): ManifestEntry {
   return entry;
 }
 
-// Main
-const manifest: ManifestEntry[] = [];
-
-if (fs.existsSync(CLIS_DIR)) {
-  for (const site of fs.readdirSync(CLIS_DIR)) {
-    const siteDir = path.join(CLIS_DIR, site);
-    if (!fs.statSync(siteDir).isDirectory()) continue;
-    for (const file of fs.readdirSync(siteDir)) {
-      const filePath = path.join(siteDir, file);
-      if (file.endsWith('.yaml') || file.endsWith('.yml')) {
-        const entry = scanYaml(filePath, site);
-        if (entry) manifest.push(entry);
-      } else if (
-        (file.endsWith('.ts') && !file.endsWith('.d.ts') && file !== 'index.ts') ||
-        (file.endsWith('.js') && !file.endsWith('.d.js') && file !== 'index.js')
-      ) {
-        manifest.push(scanTs(filePath, site));
+export function buildManifest(): ManifestEntry[] {
+  const manifest: ManifestEntry[] = [];
+
+  if (fs.existsSync(CLIS_DIR)) {
+    for (const site of fs.readdirSync(CLIS_DIR)) {
+      const siteDir = path.join(CLIS_DIR, site);
+      if (!fs.statSync(siteDir).isDirectory()) continue;
+      for (const file of fs.readdirSync(siteDir)) {
+        const filePath = path.join(siteDir, file);
+        if (file.endsWith('.yaml') || file.endsWith('.yml')) {
+          const entry = scanYaml(filePath, site);
+          if (entry) manifest.push(entry);
+        } else if (
+          (file.endsWith('.ts') && !file.endsWith('.d.ts') && file !== 'index.ts') ||
+          (file.endsWith('.js') && !file.endsWith('.d.js') && file !== 'index.js')
+        ) {
+          manifest.push(scanTs(filePath, site));
+        }
       }
     }
   }
+
+  return manifest;
 }
 
-// Ensure output directory exists
-fs.mkdirSync(path.dirname(OUTPUT), { recursive: true });
-fs.writeFileSync(OUTPUT, JSON.stringify(manifest, null, 2));
+function main(): void {
+  const manifest = buildManifest();
+  fs.mkdirSync(path.dirname(OUTPUT), { recursive: true });
+  fs.writeFileSync(OUTPUT, JSON.stringify(manifest, null, 2));
 
-const yamlCount = manifest.filter(e => e.type === 'yaml').length;
-const tsCount = manifest.filter(e => e.type === 'ts').length;
-console.log(`✅ Manifest compiled: ${manifest.length} entries (${yamlCount} YAML, ${tsCount} TS) → ${OUTPUT}`);
+  const yamlCount = manifest.filter(e => e.type === 'yaml').length;
+  const tsCount = manifest.filter(e => e.type === 'ts').length;
+  console.log(`✅ Manifest compiled: ${manifest.length} entries (${yamlCount} YAML, ${tsCount} TS) → ${OUTPUT}`);
+}
+
+const entrypoint = process.argv[1] ? pathToFileURL(path.resolve(process.argv[1])).href : null;
+if (entrypoint === import.meta.url) {
+  main();
+}

package/src/clis/antigravity/README.md

@@ -12,9 +12,8 @@ Start the Antigravity desktop app with the Chrome DevTools `remote-debugging-por
 
 \`\`\`bash
 # Start Antigravity in the background
-/Applications/Antigravity.app/Contents/MacOS/Electron \\
-  --remote-debugging-port=9224 \\
-  --remote-allow-origins="*"
+/Applications/Antigravity.app/Contents/MacOS/Electron \
+  --remote-debugging-port=9224
 \`\`\`
 
 *(Note: Depending on your installation, the executable might be named differently, e.g., \`Antigravity\` instead of \`Electron\`.)*

package/src/clis/antigravity/README.zh-CN.md

@@ -15,9 +15,8 @@ CLI all electron！现在支持把所有 electron 应用 CLI 化，从而组合
 
 \`\`\`bash
 # 在后台启动并驻留
-/Applications/Antigravity.app/Contents/MacOS/Electron \\
-  --remote-debugging-port=9224 \\
-  --remote-allow-origins="*"
+/Applications/Antigravity.app/Contents/MacOS/Electron \
+  --remote-debugging-port=9224
 \`\`\`
 
 *(注意：如果你打包的应用重命名过主构建，可能需要把 `Electron` 换成实际的可执行文件名，如 `Antigravity`)*

package/src/clis/antigravity/SKILL.md

@@ -9,7 +9,7 @@ This skill allows AI agents to control the [Antigravity](https://github.com/chen
 ## Requirements
 The target Electron application MUST be launched with the remote-debugging-port flag:
 \`\`\`bash
-/Applications/Antigravity.app/Contents/MacOS/Electron --remote-debugging-port=9224 --remote-allow-origins="*"
+/Applications/Antigravity.app/Contents/MacOS/Electron --remote-debugging-port=9224
 \`\`\`
 
 The agent must configure the endpoint environment variable locally before invoking standard commands:

package/src/clis/antigravity/model.ts

@@ -10,7 +10,7 @@ export const modelCommand = cli({
   args: [
     { name: 'name', help: 'Target model name (e.g. claude, gemini, o1)', required: true, positional: true }
   ],
-  columns: ['status'],
+  columns: ['Status'],
   func: async (page, kwargs) => {
     const targetName = kwargs.name.toLowerCase();
     
@@ -42,6 +42,6 @@ export const modelCommand = cli({
     `);
     
     await page.wait(0.5);
-    return [{ status: `Model switched to: ${kwargs.name}` }];
+    return [{ Status: `Model switched to: ${kwargs.name}` }];
   },
 });

package/src/clis/antigravity/send.ts

@@ -10,7 +10,7 @@ export const sendCommand = cli({
   args: [
     { name: 'message', help: 'The message text to send', required: true, positional: true }
   ],
-  columns: ['status', 'message'],
+  columns: ['Status', 'Message'],
   func: async (page, kwargs) => {
     const text = kwargs.message;
 
@@ -35,6 +35,6 @@ export const sendCommand = cli({
     // Press Enter to submit the message
     await page.pressKey('Enter');
     
-    return [{ status: 'Sent successfully', message: text }];
+    return [{ Status: 'Sent successfully', Message: text }];
   },
 });

package/src/clis/bilibili/download.ts

@@ -0,0 +1,161 @@
+/**
+ * Bilibili download — download videos using yt-dlp.
+ *
+ * Usage:
+ *   opencli bilibili download --bvid BV1xxx --output ./bilibili
+ *
+ * Requirements:
+ *   - yt-dlp must be installed: pip install yt-dlp
+ */
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { cli, Strategy } from '../../registry.js';
+import {
+  ytdlpDownload,
+  checkYtdlp,
+  sanitizeFilename,
+  getTempDir,
+  exportCookiesToNetscape,
+} from '../../download/index.js';
+import { DownloadProgressTracker, formatBytes } from '../../download/progress.js';
+
+cli({
+  site: 'bilibili',
+  name: 'download',
+  description: '下载B站视频（需要 yt-dlp）',
+  domain: 'www.bilibili.com',
+  strategy: Strategy.COOKIE,
+  args: [
+    { name: 'bvid', required: true, help: 'Video BV ID (e.g., BV1xxx)' },
+    { name: 'output', default: './bilibili-downloads', help: 'Output directory' },
+    { name: 'quality', default: 'best', help: 'Video quality (best, 1080p, 720p, 480p)' },
+  ],
+  columns: ['bvid', 'title', 'status', 'size'],
+  func: async (page, kwargs) => {
+    const bvid = kwargs.bvid;
+    const output = kwargs.output;
+    const quality = kwargs.quality;
+
+    // Check yt-dlp availability
+    if (!checkYtdlp()) {
+      return [{
+        bvid,
+        title: '-',
+        status: 'failed',
+        size: 'yt-dlp not installed. Run: pip install yt-dlp',
+      }];
+    }
+
+    // Navigate to video page to get title and cookies
+    await page.goto(`https://www.bilibili.com/video/${bvid}`);
+    await page.wait(3);
+
+    // Extract video info
+    const data = await page.evaluate(`
+      (() => {
+        const title = document.querySelector('h1.video-title, .video-title')?.textContent?.trim() || 'video';
+        const author = document.querySelector('.up-name, .username')?.textContent?.trim() || 'unknown';
+        return { title, author };
+      })()
+    `);
+
+    const title = sanitizeFilename(data?.title || 'video');
+
+    // Extract cookies for authenticated downloads
+    const cookieString = await page.evaluate(`(() => document.cookie)()`);
+
+    // Create output directory
+    fs.mkdirSync(output, { recursive: true });
+
+    // Export cookies to Netscape format for yt-dlp
+    let cookiesFile: string | undefined;
+    if (typeof cookieString === 'string' && cookieString) {
+      const tempDir = getTempDir();
+      fs.mkdirSync(tempDir, { recursive: true });
+      cookiesFile = path.join(tempDir, `bilibili_cookies_${Date.now()}.txt`);
+
+      const cookies = cookieString.split(';').map((c) => {
+        const [name, ...rest] = c.trim().split('=');
+        return {
+          name: name || '',
+          value: rest.join('=') || '',
+          domain: '.bilibili.com',
+          path: '/',
+          secure: true,
+          httpOnly: false,
+        };
+      }).filter((c) => c.name);
+
+      exportCookiesToNetscape(cookies, cookiesFile);
+    }
+
+    // Build yt-dlp format string based on quality
+    let format = 'bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best';
+    if (quality === '1080p') {
+      format = 'bestvideo[height<=1080][ext=mp4]+bestaudio[ext=m4a]/best[height<=1080]';
+    } else if (quality === '720p') {
+      format = 'bestvideo[height<=720][ext=mp4]+bestaudio[ext=m4a]/best[height<=720]';
+    } else if (quality === '480p') {
+      format = 'bestvideo[height<=480][ext=mp4]+bestaudio[ext=m4a]/best[height<=480]';
+    }
+
+    const destPath = path.join(output, `${bvid}_${title}.mp4`);
+
+    const tracker = new DownloadProgressTracker(1, true);
+    const progressBar = tracker.onFileStart(`${bvid}.mp4`, 0);
+
+    try {
+      const result = await ytdlpDownload(
+        `https://www.bilibili.com/video/${bvid}`,
+        destPath,
+        {
+          cookiesFile,
+          format,
+          extraArgs: [
+            '--merge-output-format', 'mp4',
+            '--embed-thumbnail',
+          ],
+          onProgress: (percent) => {
+            if (progressBar) progressBar.update(percent, 100);
+          },
+        },
+      );
+
+      if (progressBar) {
+        progressBar.complete(result.success, result.success ? formatBytes(result.size) : undefined);
+      }
+
+      tracker.onFileComplete(result.success);
+      tracker.finish();
+
+      // Cleanup cookies file
+      if (cookiesFile && fs.existsSync(cookiesFile)) {
+        fs.unlinkSync(cookiesFile);
+      }
+
+      return [{
+        bvid,
+        title: data?.title || 'video',
+        status: result.success ? 'success' : 'failed',
+        size: result.success ? formatBytes(result.size) : (result.error || 'unknown error'),
+      }];
+    } catch (err: any) {
+      if (progressBar) progressBar.fail(err.message);
+      tracker.onFileComplete(false);
+      tracker.finish();
+
+      // Cleanup cookies file
+      if (cookiesFile && fs.existsSync(cookiesFile)) {
+        fs.unlinkSync(cookiesFile);
+      }
+
+      return [{
+        bvid,
+        title: data?.title || 'video',
+        status: 'failed',
+        size: err.message,
+      }];
+    }
+  },
+});

package/src/clis/chatgpt/README.md

@@ -1,35 +1,44 @@
 # ChatGPT Desktop Adapter for OpenCLI
 
-Control the **ChatGPT macOS Desktop App** directly from the terminal via native AppleScript automation. Unlike Electron-based apps (Antigravity, Codex, Cursor), ChatGPT Desktop is a native macOS application — OpenCLI drives it using `osascript` and System Events.
+Control the **ChatGPT macOS Desktop App** directly from the terminal. OpenCLI supports two automation approaches for ChatGPT.
 
-## Prerequisites
+## 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 (Terminal / iTerm / Warp) in **System Settings → Privacy & Security → Accessibility**. This is required for System Events keystroke simulation.
 
-## Setup
-
-No extra environment variables needed — the adapter uses `osascript` directly.
-
-## Commands
-
-### Diagnostics
+### Commands
 - `opencli chatgpt status`: Check if the ChatGPT app is currently running.
-
-### Chat Manipulation
 - `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 read`: Copy the last AI response via `Cmd+Shift+C` and return it as text.
 
+## Approach 2: CDP (Advanced, Electron Debug Mode)
+
+ChatGPT Desktop is also an Electron app and can be launched with a remote debugging port for deeper automation via CDP:
+
+```bash
+/Applications/ChatGPT.app/Contents/MacOS/ChatGPT \
+  --remote-debugging-port=9224
+```
+
+Then set the endpoint:
+```bash
+export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9224"
+```
+
+> **Note**: The CDP approach enables future advanced commands like DOM inspection, model switching, and code extraction — similar to the Cursor and Codex adapters.
+
 ## How It Works
 
-Unlike CDP-based adapters, this adapter:
-- Uses `osascript` to send AppleScript commands to System Events
-- Leverages `pbcopy`/`pbpaste` for clipboard-based text transfer
-- Requires no remote debugging port — works with the stock app
+- **AppleScript mode**: Uses `osascript` and `pbcopy`/`pbpaste` for clipboard-based text transfer. No remote debugging port needed.
+- **CDP mode**: Connects via Playwright to the Electron renderer process for direct DOM manipulation.
 
 ## Limitations
 
 - macOS only (AppleScript dependency)
-- Requires Accessibility permissions for keystroke simulation
+- AppleScript mode requires Accessibility permissions
 - `read` command copies the last response — earlier messages need manual scroll

package/src/clis/chatgpt/README.zh-CN.md

@@ -1,35 +1,44 @@
 # ChatGPT 桌面端适配器
 
-通过原生 AppleScript 自动化，在终端中直接控制 **ChatGPT macOS 桌面应用**。与基于 Electron 的应用（Antigravity、Codex、Cursor）不同，ChatGPT Desktop 是原生 macOS 应用 — OpenCLI 使用 `osascript` 和 System Events 来驱动它。
+在终端中直接控制 **ChatGPT macOS 桌面应用**。OpenCLI 支持两种自动化方式。
 
-## 前置条件
+## 方式一：AppleScript（默认，无需配置）
 
-1. 安装官方 [ChatGPT Desktop App](https://openai.com/chatgpt/mac/)。
-2. 在 **系统设置 → 隐私与安全性 → 辅助功能** 中为终端应用（Terminal / iTerm / Warp）授予 **辅助功能权限**。这是 System Events 按键模拟所必需的。
-
-## 配置
-
-无需额外环境变量 — 适配器直接使用 `osascript`。
+内置命令使用原生 AppleScript 自动化，无需额外启动参数。
 
-## 命令
+### 前置条件
+1. 安装官方 [ChatGPT Desktop App](https://openai.com/chatgpt/mac/)。
+2. 在 **系统设置 → 隐私与安全性 → 辅助功能** 中为终端应用授予权限。
 
-### 诊断
+### 命令
 - `opencli chatgpt status`：检查 ChatGPT 应用是否在运行。
-
-### 对话操作
 - `opencli chatgpt new`：激活 ChatGPT 并按 `Cmd+N` 开始新对话。
 - `opencli chatgpt send "消息"`：将消息复制到剪贴板，激活 ChatGPT，粘贴并提交。
 - `opencli chatgpt read`：通过 `Cmd+Shift+C` 复制最后一条 AI 回复并返回文本。
 
+## 方式二：CDP（高级，Electron 调试模式）
+
+ChatGPT Desktop 同样是 Electron 应用，可以通过远程调试端口启动以实现更深度的自动化：
+
+```bash
+/Applications/ChatGPT.app/Contents/MacOS/ChatGPT \
+  --remote-debugging-port=9224
+```
+
+然后设置环境变量：
+```bash
+export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9224"
+```
+
+> **注意**：CDP 模式支持未来的高级命令（如 DOM 检查、模型切换、代码提取等），与 Cursor 和 Codex 适配器类似。
+
 ## 工作原理
 
-与基于 CDP 的适配器不同，此适配器：
-- 使用 `osascript` 向 System Events 发送 AppleScript 命令
-- 利用 `pbcopy`/`pbpaste` 进行基于剪贴板的文本传输
-- 无需远程调试端口 — 直接与原生应用交互
+- **AppleScript 模式**：使用 `osascript` 和 `pbcopy`/`pbpaste` 进行剪贴板文本传输，无需远程调试端口。
+- **CDP 模式**：通过 Playwright 连接到 Electron 渲染进程，直接操作 DOM。
 
 ## 限制
 
 - 仅支持 macOS（AppleScript 依赖）
-- 需要辅助功能权限以模拟按键
-- `read` 命令复制最后一条回复 — 更早的消息需要手动滚动
+- AppleScript 模式需要辅助功能权限
+- `read` 命令复制最后一条回复，更早的消息需手动滚动

package/src/clis/chatgpt/ask.ts

@@ -0,0 +1,77 @@
+import { execSync, spawnSync } from 'node:child_process';
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const askCommand = cli({
+  site: 'chatgpt',
+  name: 'ask',
+  description: 'Send a prompt and wait for the AI response (send + wait + read)',
+  domain: 'localhost',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'text', required: true, positional: true, help: 'Prompt to send' },
+    { name: 'timeout', required: false, help: 'Max seconds to wait for response (default: 30)', default: '30' },
+  ],
+  columns: ['Role', 'Text'],
+  func: async (page: IPage | null, kwargs: any) => {
+    const text = kwargs.text as string;
+    const timeout = parseInt(kwargs.timeout as string, 10) || 30;
+
+    // Backup clipboard
+    let clipBackup = '';
+    try { clipBackup = execSync('pbpaste', { encoding: 'utf-8' }); } catch {}
+
+    // Send the message
+    spawnSync('pbcopy', { input: text });
+    execSync("osascript -e 'tell application \"ChatGPT\" to activate'");
+    execSync("osascript -e 'delay 0.5'");
+
+    const cmd = "osascript " +
+                "-e 'tell application \"System Events\"' " +
+                "-e 'keystroke \"v\" using command down' " +
+                "-e 'delay 0.2' " +
+                "-e 'keystroke return' " +
+                "-e 'end tell'";
+    execSync(cmd);
+
+    // Clear clipboard marker
+    spawnSync('pbcopy', { input: '__OPENCLI_WAITING__' });
+
+    // Wait for response, then read it
+    const pollInterval = 3;
+    const maxPolls = Math.ceil(timeout / pollInterval);
+    let response = '';
+
+    for (let i = 0; i < maxPolls; i++) {
+      // Wait
+      execSync(`sleep ${pollInterval}`);
+
+      // Try Cmd+Shift+C to copy the latest response
+      execSync("osascript -e 'tell application \"ChatGPT\" to activate'");
+      execSync("osascript -e 'tell application \"System Events\" to keystroke \"c\" using {command down, shift down}'");
+      execSync("osascript -e 'delay 0.3'");
+
+      const copied = execSync('pbpaste', { encoding: 'utf-8' }).trim();
+      if (copied && copied !== '__OPENCLI_WAITING__' && copied !== text) {
+        response = copied;
+        break;
+      }
+    }
+
+    // Restore clipboard
+    if (clipBackup) spawnSync('pbcopy', { input: clipBackup });
+
+    if (!response) {
+      return [
+        { Role: 'User', Text: text },
+        { Role: 'System', Text: `No response within ${timeout}s. ChatGPT may still be generating.` },
+      ];
+    }
+
+    return [
+      { Role: 'User', Text: text },
+      { Role: 'Assistant', Text: response },
+    ];
+  },
+});