@jackwener/opencli 0.9.2 → 0.9.4

package/CLI-ELECTRON.md

@@ -0,0 +1,72 @@
+---
+description: How to CLI-ify and automate any Electron Desktop Application via CDP
+---
+
+# CLI-ifying Electron Applications (Skill Guide)
+
+Based on the successful extraction and automation of **Antigravity** and **OpenAI Codex** desktop apps, this guide serves as the standard operating procedure (SOP) for adapting ANY Electron-based application into an OpenCLI adapter.
+
+## 核心原理 (Core Concept)
+Electron 应用本质上是运行在本地的 Chromium 浏览器实例。只要在启动应用时暴露了调试端口（CDP，Chrome DevTools Protocol），我们就可以利用 Playwright MCP 直接穿透其 UI 层，获取并操控包括 React/Vue 组件、Shadow DOM 等在内的所有底层状态，实现“从应用外挂入自动化脚本”。
+
+### 启动 Target App 
+要在本地操作任何 Electron 应用，必须先要求用户使用以下参数注入调试端点：
+```bash
+/Applications/AppName.app/Contents/MacOS/AppName --remote-debugging-port=9222
+```
+
+## 标准适配模式：The 5-Command Pattern
+
+适配一个新的 App，必须在 `src/clis/<app_name>/` 下实现这 5 个标准化指令：
+
+### 1. `status.ts` (连接测试)
+负责确认应用监听正确。
+- **机制**: 直接 `export const statusCommand = cli({...})`
+- **核心代码**: 获取 `window.location.href` 与 `document.title`。
+- **注意**: 必须指明 `domain: 'localhost'` 和 `browser: true`。
+
+### 2. `dump.ts` (逆向工程核心)
+很多现代 App DOM 极其庞大且混淆。**千万不要直接猜选择器**。
+首先编写 dump 脚本，将当前页面的 DOM 与 Accessibility Tree 导出到 `/tmp/`，方便用 AI (或者 `grep`) 提取精确的容器名称和 Class。
+```typescript
+const dom = await page.evaluate('document.body.innerHTML');
+fs.writeFileSync('/tmp/app-dom.html', dom);
+const snap = await page.snapshot({ interactive: false });
+fs.writeFileSync('/tmp/app-snapshot.json', JSON.stringify(snap, null, 2));
+```
+
+### 3. `send.ts` (高级注入技巧)
+Electron 应用常常使用极端复杂的富文本编辑器（如 Monaco, Lexical, ProseMirror）。直接修改元素的 `value` 常常会被 React 状态机忽略。
+- **最佳实践**: 使用 `document.execCommand('insertText')` 完美模拟真实的人类复制粘贴输入流，完全穿透 React state。
+```javascript
+// 寻路机制：优先尝试寻找 contenteditable
+let composer = document.querySelector('[contenteditable="true"]');
+composer.focus();
+document.execCommand('insertText', false, "你好");
+```
+- **提交快捷键**: `await page.pressKey('Enter')`。
+
+### 4. `read.ts` (上下文解析)
+不要提取整个页面的文本。应该利用 `dump.ts` 抓取出来的特征寻找真正的“对话容器”。
+- **技巧**: 检查带有语义化结构的数据，例如 `[role="log"]`、`[data-testid="conversation"]` 或是 `[data-content-search-turn-key]`。
+- **格式化**: 拼接抓取出的文本转粗暴渲染成 Markdown 返回，这样不仅你和人类能读懂，LLM 后续作为 Agent 也能精准切分。
+
+### 5. `new.ts` / Action Macros (底层事件模拟)
+许多图形界面操作难以找到按钮实例，但它们通常响应原生快捷键。
+- **最佳实践**: 模拟系统级快捷键直接驱动 `(Meta+N / Control+N)`。
+```typescript
+const isMac = process.platform === 'darwin';
+await page.pressKey(isMac ? 'Meta+N' : 'Control+N');
+await page.wait(1); // 等待重渲染
+```
+
+## 全局环境变量
+为了让 Core Framework 挂载到我们指定的端口，必须在执行指令前（或在 README 中指导用户）注入目标环境端口：
+```bash
+export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9222"
+```
+
+## 踩坑避雷 (Pitfalls & Gotchas)
+1. **端口占用 (EADDRINUSE)**: 确保同一时间只能有一个 App 占据一个端口。如果同时测试 Antigravity (9224) 且你要测试别的 App (9222)，要将 CDP Endpoint 分配开来。
+2. **TypeScript 抽象**: OpenCLI 内部封装了 `IPage` 类型（`src/types.ts`），不是原生的 Playwright Page。要用 `page.pressKey()` 和 `page.evaluate()`，而非 `page.keyboard.press()`。
+3. **延时等待**: DOM 发生剧烈变化后，一定要加上 `await page.wait(0.5)` 到 `1.0` 给框架反应的时间。不要立刻 return 导致连接 prematurely 阻断。

package/README.md

@@ -149,7 +149,16 @@ npm install -g @jackwener/opencli@latest
 |------|----------|:-----:|------|
 | **twitter** | `trending` `bookmarks` `profile` `search` `timeline` `thread` `following` `followers` `notifications` `post` `reply` `delete` `like` `article` `follow` `unfollow` `bookmark` `unbookmark` | 18 | 🔐 Browser |
 | **reddit** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` | 15 | 🔐 Browser |
+| **antigravity** | `status` `send` `read` `new` `evaluate` | 5 | 🖥️ Desktop |
+| **bbc** | `news` | 1 | 🌐 Public |
 | **bilibili** | `hot` `search` `me` `favorite` `history` `feed` `subtitle` `dynamic` `ranking` `following` `user-videos` | 11 | 🔐 Browser |
+| **boss** | `search` `detail` | 2 | 🔐 Browser |
+| **codex** | `status` `send` `read` `new` `extract-diff` `model` | 6 | 🖥️ Desktop |
+| **coupang** | `search` `add-to-cart` | 2 | 🔐 Browser |
+| **ctrip** | `search` | 1 | 🔐 Browser |
+| **cursor** | `status` `send` `read` `new` `dump` `composer` `model` | 7 | 🖥️ Desktop |
+| **github** | `search` | 1 | 🌐 Public |
+| **hackernews** | `top` | 1 | 🌐 Public |
 | **v2ex** | `hot` `latest` `topic` `daily` `me` `notifications` | 6 | 🌐 / 🔐 |
 | **xueqiu** | `feed` `hot-stock` `hot` `search` `stock` `watchlist` | 6 | 🔐 Browser |
 | **xiaohongshu** | `search` `notifications` `feed` `me` `user` | 5 | 🔐 Browser |

package/README.zh-CN.md

@@ -150,6 +150,9 @@ npm install -g @jackwener/opencli@latest
 |------|------|:----:|------|
 | **twitter** | `trending` `bookmarks` `profile` `search` `timeline` `thread` `following` `followers` `notifications` `post` `reply` `delete` `like` `article` `follow` `unfollow` `bookmark` `unbookmark` | 18 | 🔐 浏览器 |
 | **reddit** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` | 15 | 🔐 浏览器 |
+| **antigravity** | `status` `send` `read` `new` `evaluate` | 5 | 🖥️ 桌面端 |
+| **codex** | `status` `send` `read` `new` `extract-diff` `model` | 6 | 🖥️ 桌面端 |
+| **cursor** | `status` `send` `read` `new` `dump` `composer` `model` | 7 | 🖥️ 桌面端 |
 | **bilibili** | `hot` `search` `me` `favorite` `history` `feed` `subtitle` `dynamic` `ranking` `following` `user-videos` | 11 | 🔐 浏览器 |
 | **v2ex** | `hot` `latest` `topic` `daily` `me` `notifications` | 6 | 🌐 / 🔐 |
 | **xueqiu** | `feed` `hot-stock` `hot` `search` `stock` `watchlist` | 6 | 🔐 浏览器 |

package/dist/cli-manifest.json

@@ -840,6 +840,29 @@
       "Diff"
     ]
   },
+  {
+    "site": "codex",
+    "name": "model",
+    "description": "Get or switch the currently active AI model in Codex Desktop",
+    "strategy": "ui",
+    "browser": true,
+    "args": [
+      {
+        "name": "model_name",
+        "type": "str",
+        "required": false,
+        "positional": true,
+        "help": "The ID of the model to switch to (e.g. gpt-4)"
+      }
+    ],
+    "type": "ts",
+    "modulePath": "codex/model.js",
+    "domain": "localhost",
+    "columns": [
+      "Status",
+      "Model"
+    ]
+  },
   {
     "site": "codex",
     "name": "new",
@@ -1021,6 +1044,149 @@
       "url"
     ]
   },
+  {
+    "site": "cursor",
+    "name": "composer",
+    "description": "Send a prompt directly into Cursor Composer (Cmd+I shortcut)",
+    "strategy": "ui",
+    "browser": true,
+    "args": [
+      {
+        "name": "text",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Text to send into Composer"
+      }
+    ],
+    "type": "ts",
+    "modulePath": "cursor/composer.js",
+    "domain": "localhost",
+    "columns": [
+      "Status",
+      "InjectedText"
+    ]
+  },
+  {
+    "site": "cursor",
+    "name": "dump",
+    "description": "Dump the DOM and Accessibility tree of Cursor for reverse-engineering",
+    "strategy": "ui",
+    "browser": true,
+    "args": [],
+    "type": "ts",
+    "modulePath": "cursor/dump.js",
+    "domain": "localhost",
+    "columns": [
+      "action",
+      "files"
+    ]
+  },
+  {
+    "site": "cursor",
+    "name": "extract-code",
+    "description": "Extract multi-line code blocks from the current Cursor conversation",
+    "strategy": "ui",
+    "browser": true,
+    "args": [],
+    "type": "ts",
+    "modulePath": "cursor/extract-code.js",
+    "domain": "localhost",
+    "columns": [
+      "Code"
+    ]
+  },
+  {
+    "site": "cursor",
+    "name": "model",
+    "description": "Get or switch the currently active AI model in Cursor",
+    "strategy": "ui",
+    "browser": true,
+    "args": [
+      {
+        "name": "model_name",
+        "type": "str",
+        "required": false,
+        "positional": true,
+        "help": "The ID of the model to switch to (e.g. claude-3.5-sonnet)"
+      }
+    ],
+    "type": "ts",
+    "modulePath": "cursor/model.js",
+    "domain": "localhost",
+    "columns": [
+      "Status",
+      "Model"
+    ]
+  },
+  {
+    "site": "cursor",
+    "name": "new",
+    "description": "Start a new Cursor chat or Composer session",
+    "strategy": "ui",
+    "browser": true,
+    "args": [],
+    "type": "ts",
+    "modulePath": "cursor/new.js",
+    "domain": "localhost",
+    "columns": [
+      "Status"
+    ]
+  },
+  {
+    "site": "cursor",
+    "name": "read",
+    "description": "Read the current Cursor chat/composer conversation history",
+    "strategy": "ui",
+    "browser": true,
+    "args": [],
+    "type": "ts",
+    "modulePath": "cursor/read.js",
+    "domain": "localhost",
+    "columns": [
+      "Role",
+      "Text"
+    ]
+  },
+  {
+    "site": "cursor",
+    "name": "send",
+    "description": "Send a prompt directly into Cursor Composer/Chat",
+    "strategy": "ui",
+    "browser": true,
+    "args": [
+      {
+        "name": "text",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Text to send into Cursor"
+      }
+    ],
+    "type": "ts",
+    "modulePath": "cursor/send.js",
+    "domain": "localhost",
+    "columns": [
+      "Status",
+      "InjectedText"
+    ]
+  },
+  {
+    "site": "cursor",
+    "name": "status",
+    "description": "Check active CDP connection to Cursor AI Editor",
+    "strategy": "ui",
+    "browser": true,
+    "args": [],
+    "type": "ts",
+    "modulePath": "cursor/status.js",
+    "domain": "localhost",
+    "columns": [
+      "Status",
+      "Url",
+      "Title"
+    ]
+  },
   {
     "site": "hackernews",
     "name": "top",

package/dist/clis/codex/model.d.ts

@@ -0,0 +1 @@
+export declare const modelCommand: import("../../registry.js").CliCommand;

package/dist/clis/codex/model.js

@@ -0,0 +1,55 @@
+import { cli, Strategy } from '../../registry.js';
+export const modelCommand = cli({
+    site: 'codex',
+    name: 'model',
+    description: 'Get or switch the currently active AI model in Codex Desktop',
+    domain: 'localhost',
+    strategy: Strategy.UI,
+    browser: true,
+    args: [
+        { name: 'model_name', required: false, positional: true, help: 'The ID of the model to switch to (e.g. gpt-4)' }
+    ],
+    columns: ['Status', 'Model'],
+    func: async (page, kwargs) => {
+        const desiredModel = kwargs.model_name;
+        if (!desiredModel) {
+            // Just read the current model. We traverse iframes/webviews if needed.
+            const currentModel = await page.evaluate(`
+        (function() {
+          // Look for any typical model switcher selectors in the DOM
+          let m = document.querySelector('[title*="Model"], [aria-label*="Model"], .model-selector, [class*="ModelPicker"]');
+          
+          if (!m && document.querySelector('webview, iframe')) {
+              // Not directly in main DOM, might be in a webview, but Playwright evaluate doesn't cross origin boundaries easily without frames[].
+              return 'Unknown (Likely inside a WebView, please focus the Chat tab)';
+          }
+          return m ? (m.textContent || m.getAttribute('title') || m.getAttribute('aria-label')).trim() : 'Unknown or Not Found';
+        })()
+      `);
+            return [
+                {
+                    Status: 'Active',
+                    Model: currentModel,
+                },
+            ];
+        }
+        else {
+            // Try to switch model (click dropdown, type/select model)
+            const success = await page.evaluate(`
+        (function(targetModel) {
+          const dropdown = document.querySelector('[title*="Model"], [aria-label*="Model"], .model-selector, [class*="ModelPicker"]');
+          if (!dropdown) return 'Dropdown not found';
+          
+          dropdown.click();
+          return 'Dropdown clicked. Generic interaction initiated.';
+        })(${JSON.stringify(desiredModel)})
+      `);
+            return [
+                {
+                    Status: success,
+                    Model: desiredModel,
+                },
+            ];
+        }
+    },
+});

package/dist/clis/cursor/composer.d.ts

@@ -0,0 +1 @@
+export declare const composerCommand: import("../../registry.js").CliCommand;

package/dist/clis/cursor/composer.js

@@ -0,0 +1,60 @@
+import { cli, Strategy } from '../../registry.js';
+export const composerCommand = cli({
+    site: 'cursor',
+    name: 'composer',
+    description: 'Send a prompt directly into Cursor Composer (Cmd+I shortcut)',
+    domain: 'localhost',
+    strategy: Strategy.UI,
+    browser: true,
+    args: [{ name: 'text', required: true, positional: true, help: 'Text to send into Composer' }],
+    columns: ['Status', 'InjectedText'],
+    func: async (page, kwargs) => {
+        const textToInsert = kwargs.text;
+        const injected = await page.evaluate(`(async function() {
+        let isComposerVisible = document.querySelector('.composer-bar') !== null || document.querySelector('#composer-toolbar-section') !== null;
+        return isComposerVisible;
+      })()`);
+        if (!injected) {
+            await page.pressKey('Meta+I');
+            await page.wait(1.0);
+        }
+        else {
+            // Just focus it if it's open but unfocused (we can't easily know if it's focused without triggering something)
+            await page.pressKey('Meta+I');
+            await page.wait(0.2);
+            const isStillVisible = await page.evaluate('document.querySelector(".composer-bar") !== null');
+            if (!isStillVisible) {
+                await page.pressKey('Meta+I'); // Re-open
+                await page.wait(0.5);
+            }
+        }
+        const typed = await page.evaluate(`(function(text) {
+        let composer = document.querySelector('.composer-bar [data-lexical-editor="true"], [id*="composer"] [contenteditable="true"], .aislash-editor-input');
+        
+        if (!composer) {
+            composer = document.activeElement;
+            if (!composer || !composer.isContentEditable) {
+                return false;
+            }
+        }
+
+        composer.focus();
+        document.execCommand('insertText', false, text);
+        return true;
+      })(${JSON.stringify(textToInsert)})`);
+        if (!typed) {
+            throw new Error('Could not find Cursor Composer input element after pressing Cmd+I.');
+        }
+        // Submit the command. In Cursor Composer, Enter usually submits if it's not a multi-line edit.
+        // Sometimes Cmd+Enter is needed? We'll just submit standard Enter.
+        await page.wait(0.5);
+        await page.pressKey('Enter');
+        await page.wait(1);
+        return [
+            {
+                Status: 'Success (Composer)',
+                InjectedText: textToInsert,
+            },
+        ];
+    },
+});

package/dist/clis/cursor/dump.d.ts

@@ -0,0 +1 @@
+export declare const dumpCommand: import("../../registry.js").CliCommand;

package/dist/clis/cursor/dump.js

@@ -0,0 +1,25 @@
+import { cli, Strategy } from '../../registry.js';
+import * as fs from 'fs';
+export const dumpCommand = cli({
+    site: 'cursor',
+    name: 'dump',
+    description: 'Dump the DOM and Accessibility tree of Cursor for reverse-engineering',
+    domain: 'localhost',
+    strategy: Strategy.UI,
+    browser: true,
+    columns: ['action', 'files'],
+    func: async (page) => {
+        // Extract full HTML
+        const dom = await page.evaluate('document.body.innerHTML');
+        fs.writeFileSync('/tmp/cursor-dom.html', dom);
+        // Get accessibility snapshot
+        const snap = await page.snapshot({ interactive: false });
+        fs.writeFileSync('/tmp/cursor-snapshot.json', JSON.stringify(snap, null, 2));
+        return [
+            {
+                action: 'Dom extraction finished',
+                files: '/tmp/cursor-dom.html, /tmp/cursor-snapshot.json',
+            },
+        ];
+    },
+});

package/dist/clis/cursor/extract-code.d.ts

@@ -0,0 +1 @@
+export declare const extractCodeCommand: import("../../registry.js").CliCommand;

package/dist/clis/cursor/extract-code.js

@@ -0,0 +1,35 @@
+import { cli, Strategy } from '../../registry.js';
+export const extractCodeCommand = cli({
+    site: 'cursor',
+    name: 'extract-code',
+    description: 'Extract multi-line code blocks from the current Cursor conversation',
+    domain: 'localhost',
+    strategy: Strategy.UI,
+    browser: true,
+    args: [],
+    columns: ['Code'],
+    func: async (page) => {
+        const blocks = await page.evaluate(`
+      (function() {
+        // Find standard pre/code blocks
+        let elements = Array.from(document.querySelectorAll('pre code, .markdown-root pre'));
+        
+        // Fallback to Monaco editor content inside the UI
+        if (elements.length === 0) {
+          elements = Array.from(document.querySelectorAll('.monaco-editor'));
+        }
+        
+        // Generic fallback to any code tag that spans multiple lines
+        if (elements.length === 0) {
+          elements = Array.from(document.querySelectorAll('code')).filter(c => c.innerText.includes('\\n'));
+        }
+        
+        return elements.map(el => el.innerText || el.textContent || '').filter(text => text.trim().length > 0);
+      })()
+    `);
+        if (!blocks || blocks.length === 0) {
+            return [{ Code: 'No code blocks found in Cursor.' }];
+        }
+        return blocks.map((code) => ({ Code: code }));
+    },
+});

package/dist/clis/cursor/model.d.ts

@@ -0,0 +1 @@
+export declare const modelCommand: import("../../registry.js").CliCommand;

package/dist/clis/cursor/model.js

@@ -0,0 +1,53 @@
+import { cli, Strategy } from '../../registry.js';
+export const modelCommand = cli({
+    site: 'cursor',
+    name: 'model',
+    description: 'Get or switch the currently active AI model in Cursor',
+    domain: 'localhost',
+    strategy: Strategy.UI,
+    browser: true,
+    args: [
+        { name: 'model_name', required: false, positional: true, help: 'The ID of the model to switch to (e.g. claude-3.5-sonnet)' }
+    ],
+    columns: ['Status', 'Model'],
+    func: async (page, kwargs) => {
+        const desiredModel = kwargs.model_name;
+        if (!desiredModel) {
+            // Just read the current model
+            const currentModel = await page.evaluate(`
+        (function() {
+          const m = document.querySelector('.composer-unified-dropdown-model span, [class*="unifiedmodeldropdown"] span');
+          return m ? m.textContent.trim() : 'Unknown or Not Found';
+        })()
+      `);
+            return [
+                {
+                    Status: 'Active',
+                    Model: currentModel,
+                },
+            ];
+        }
+        else {
+            // Try to switch model (click dropdown, type/select model)
+            const success = await page.evaluate(`
+        (function(targetModel) {
+          const dropdown = document.querySelector('.composer-unified-dropdown-model, [class*="unifiedmodeldropdown"]');
+          if (!dropdown) return 'Dropdown not found';
+          
+          dropdown.click();
+          // After clicking, the DOM usually spawns a popup list.
+          // Because it's hard to predict exactly how the list renders, 
+          // a simple scriptable approach is just to click it, and hope we can select it via UI.
+          // In many React apps, clicking it opens a menu, and clicking the item works.
+          return 'Dropdown opened. Automated switching is not fully generic. Please implement precise list navigation depending on DOM.';
+        })(${JSON.stringify(desiredModel)})
+      `);
+            return [
+                {
+                    Status: success,
+                    Model: desiredModel,
+                },
+            ];
+        }
+    },
+});

package/dist/clis/cursor/new.d.ts

@@ -0,0 +1 @@
+export declare const newCommand: import("../../registry.js").CliCommand;

package/dist/clis/cursor/new.js

@@ -0,0 +1,27 @@
+import { cli, Strategy } from '../../registry.js';
+export const newCommand = cli({
+    site: 'cursor',
+    name: 'new',
+    description: 'Start a new Cursor chat or Composer session',
+    domain: 'localhost',
+    strategy: Strategy.UI,
+    browser: true,
+    columns: ['Status'],
+    func: async (page) => {
+        const success = await page.evaluate(`
+      (function() {
+        const newChatButton = document.querySelector('[aria-label="New Chat"], [aria-label="New Chat (⌘N)"], .agent-sidebar-new-agent-button');
+        if (newChatButton) {
+            newChatButton.click();
+            return true;
+        }
+        return false;
+      })()
+    `);
+        if (!success) {
+            throw new Error('Could not find New Chat button in Cursor DOM.');
+        }
+        await page.wait(1);
+        return [{ Status: 'Success' }];
+    },
+});

package/dist/clis/cursor/read.d.ts

@@ -0,0 +1 @@
+export declare const readCommand: import("../../registry.js").CliCommand;

package/dist/clis/cursor/read.js

@@ -0,0 +1,43 @@
+import { cli, Strategy } from '../../registry.js';
+export const readCommand = cli({
+    site: 'cursor',
+    name: 'read',
+    description: 'Read the current Cursor chat/composer conversation history',
+    domain: 'localhost',
+    strategy: Strategy.UI,
+    browser: true,
+    columns: ['Role', 'Text'],
+    func: async (page) => {
+        const history = await page.evaluate(`
+      (function() {
+        const messages = Array.from(document.querySelectorAll('[data-message-role]'));
+        
+        if (messages.length === 0) {
+            return [];
+        }
+
+        return messages.map(msg => {
+            const role = msg.getAttribute('data-message-role');
+            let text = '';
+            
+            // Try to get structured markdown root for AI, or lexical text for human
+            const markdownRoot = msg.querySelector('.markdown-root');
+            if (markdownRoot) {
+                text = markdownRoot.innerText || markdownRoot.textContent;
+            } else {
+                text = msg.innerText || msg.textContent;
+            }
+
+            return {
+                Role: role === 'human' ? 'User' : 'Assistant',
+                Text: text.trim()
+            };
+        });
+      })()
+    `);
+        if (!history || history.length === 0) {
+            throw new Error('No conversation history found in Cursor.');
+        }
+        return history;
+    },
+});

package/dist/clis/cursor/send.d.ts

@@ -0,0 +1 @@
+export declare const sendCommand: import("../../registry.js").CliCommand;

package/dist/clis/cursor/send.js

@@ -0,0 +1,39 @@
+import { cli, Strategy } from '../../registry.js';
+export const sendCommand = cli({
+    site: 'cursor',
+    name: 'send',
+    description: 'Send a prompt directly into Cursor Composer/Chat',
+    domain: 'localhost',
+    strategy: Strategy.UI,
+    browser: true,
+    args: [{ name: 'text', required: true, positional: true, help: 'Text to send into Cursor' }],
+    columns: ['Status', 'InjectedText'],
+    func: async (page, kwargs) => {
+        const textToInsert = kwargs.text;
+        const injected = await page.evaluate(`(function(text) {
+        // Find the Lexical editor input for Composer or Chat
+        let composer = document.querySelector('.aislash-editor-input, [data-lexical-editor="true"], [contenteditable="true"]');
+        
+        if (!composer) {
+            return false;
+        }
+
+        composer.focus();
+        document.execCommand('insertText', false, text);
+        return true;
+      })(${JSON.stringify(textToInsert)})`);
+        if (!injected) {
+            throw new Error('Could not find Cursor Composer input element.');
+        }
+        // Submit the command. In Cursor, Enter usually submits the chat.
+        await page.wait(0.5);
+        await page.pressKey('Enter');
+        await page.wait(1);
+        return [
+            {
+                Status: 'Success',
+                InjectedText: textToInsert,
+            },
+        ];
+    },
+});

package/dist/clis/cursor/status.d.ts

@@ -0,0 +1 @@
+export declare const statusCommand: import("../../registry.js").CliCommand;

package/dist/clis/cursor/status.js

@@ -0,0 +1,21 @@
+import { cli, Strategy } from '../../registry.js';
+export const statusCommand = cli({
+    site: 'cursor',
+    name: 'status',
+    description: 'Check active CDP connection to Cursor AI Editor',
+    domain: 'localhost',
+    strategy: Strategy.UI, // Interactive UI manipulation
+    browser: true,
+    columns: ['Status', 'Url', 'Title'],
+    func: async (page) => {
+        const url = await page.evaluate('window.location.href');
+        const title = await page.evaluate('document.title');
+        return [
+            {
+                Status: 'Connected',
+                Url: url,
+                Title: title,
+            },
+        ];
+    },
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jackwener/opencli",
-  "version": "0.9.2",
+  "version": "0.9.4",
   "publishConfig": {
     "access": "public"
   },

package/src/clis/codex/model.ts

@@ -0,0 +1,59 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const modelCommand = cli({
+  site: 'codex',
+  name: 'model',
+  description: 'Get or switch the currently active AI model in Codex Desktop',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  args: [
+    { name: 'model_name', required: false, positional: true, help: 'The ID of the model to switch to (e.g. gpt-4)' }
+  ],
+  columns: ['Status', 'Model'],
+  func: async (page: IPage, kwargs: any) => {
+    const desiredModel = kwargs.model_name as string | undefined;
+
+    if (!desiredModel) {
+      // Just read the current model. We traverse iframes/webviews if needed.
+      const currentModel = await page.evaluate(`
+        (function() {
+          // Look for any typical model switcher selectors in the DOM
+          let m = document.querySelector('[title*="Model"], [aria-label*="Model"], .model-selector, [class*="ModelPicker"]');
+          
+          if (!m && document.querySelector('webview, iframe')) {
+              // Not directly in main DOM, might be in a webview, but Playwright evaluate doesn't cross origin boundaries easily without frames[].
+              return 'Unknown (Likely inside a WebView, please focus the Chat tab)';
+          }
+          return m ? (m.textContent || m.getAttribute('title') || m.getAttribute('aria-label')).trim() : 'Unknown or Not Found';
+        })()
+      `);
+      
+      return [
+        {
+          Status: 'Active',
+          Model: currentModel,
+        },
+      ];
+    } else {
+      // Try to switch model (click dropdown, type/select model)
+      const success = await page.evaluate(`
+        (function(targetModel) {
+          const dropdown = document.querySelector('[title*="Model"], [aria-label*="Model"], .model-selector, [class*="ModelPicker"]');
+          if (!dropdown) return 'Dropdown not found';
+          
+          dropdown.click();
+          return 'Dropdown clicked. Generic interaction initiated.';
+        })(${JSON.stringify(desiredModel)})
+      `);
+      
+      return [
+        {
+          Status: success,
+          Model: desiredModel,
+        },
+      ];
+    }
+  },
+});

package/src/clis/cursor/composer.ts

@@ -0,0 +1,71 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const composerCommand = cli({
+  site: 'cursor',
+  name: 'composer',
+  description: 'Send a prompt directly into Cursor Composer (Cmd+I shortcut)',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  args: [{ name: 'text', required: true, positional: true, help: 'Text to send into Composer' }],
+  columns: ['Status', 'InjectedText'],
+  func: async (page: IPage, kwargs: any) => {
+    const textToInsert = kwargs.text as string;
+
+    const injected = await page.evaluate(
+      `(async function() {
+        let isComposerVisible = document.querySelector('.composer-bar') !== null || document.querySelector('#composer-toolbar-section') !== null;
+        return isComposerVisible;
+      })()`
+    );
+
+    if (!injected) {
+      await page.pressKey('Meta+I');
+      await page.wait(1.0);
+    } else {
+      // Just focus it if it's open but unfocused (we can't easily know if it's focused without triggering something)
+      await page.pressKey('Meta+I');
+      await page.wait(0.2);
+      const isStillVisible = await page.evaluate('document.querySelector(".composer-bar") !== null');
+      if (!isStillVisible) {
+        await page.pressKey('Meta+I'); // Re-open
+        await page.wait(0.5);
+      }
+    }
+
+    const typed = await page.evaluate(
+      `(function(text) {
+        let composer = document.querySelector('.composer-bar [data-lexical-editor="true"], [id*="composer"] [contenteditable="true"], .aislash-editor-input');
+        
+        if (!composer) {
+            composer = document.activeElement;
+            if (!composer || !composer.isContentEditable) {
+                return false;
+            }
+        }
+
+        composer.focus();
+        document.execCommand('insertText', false, text);
+        return true;
+      })(${JSON.stringify(textToInsert)})`
+    );
+
+    if (!typed) {
+      throw new Error('Could not find Cursor Composer input element after pressing Cmd+I.');
+    }
+
+    // Submit the command. In Cursor Composer, Enter usually submits if it's not a multi-line edit.
+    // Sometimes Cmd+Enter is needed? We'll just submit standard Enter.
+    await page.wait(0.5);
+    await page.pressKey('Enter');
+    await page.wait(1);
+
+    return [
+      {
+        Status: 'Success (Composer)',
+        InjectedText: textToInsert,
+      },
+    ];
+  },
+});

package/src/clis/cursor/dump.ts

@@ -0,0 +1,28 @@
+import { cli, Strategy } from '../../registry.js';
+import * as fs from 'fs';
+
+export const dumpCommand = cli({
+  site: 'cursor',
+  name: 'dump',
+  description: 'Dump the DOM and Accessibility tree of Cursor for reverse-engineering',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  columns: ['action', 'files'],
+  func: async (page) => {
+    // Extract full HTML
+    const dom = await page.evaluate('document.body.innerHTML');
+    fs.writeFileSync('/tmp/cursor-dom.html', dom);
+
+    // Get accessibility snapshot
+    const snap = await page.snapshot({ interactive: false });
+    fs.writeFileSync('/tmp/cursor-snapshot.json', JSON.stringify(snap, null, 2));
+
+    return [
+      {
+        action: 'Dom extraction finished',
+        files: '/tmp/cursor-dom.html, /tmp/cursor-snapshot.json',
+      },
+    ];
+  },
+});

package/src/clis/cursor/extract-code.ts

@@ -0,0 +1,39 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const extractCodeCommand = cli({
+  site: 'cursor',
+  name: 'extract-code',
+  description: 'Extract multi-line code blocks from the current Cursor conversation',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  args: [],
+  columns: ['Code'],
+  func: async (page: IPage) => {
+    const blocks = await page.evaluate(`
+      (function() {
+        // Find standard pre/code blocks
+        let elements = Array.from(document.querySelectorAll('pre code, .markdown-root pre'));
+        
+        // Fallback to Monaco editor content inside the UI
+        if (elements.length === 0) {
+          elements = Array.from(document.querySelectorAll('.monaco-editor'));
+        }
+        
+        // Generic fallback to any code tag that spans multiple lines
+        if (elements.length === 0) {
+          elements = Array.from(document.querySelectorAll('code')).filter(c => c.innerText.includes('\\n'));
+        }
+        
+        return elements.map(el => el.innerText || el.textContent || '').filter(text => text.trim().length > 0);
+      })()
+    `);
+    
+    if (!blocks || blocks.length === 0) {
+      return [{ Code: 'No code blocks found in Cursor.' }];
+    }
+
+    return blocks.map((code: string) => ({ Code: code }));
+  },
+});

package/src/clis/cursor/model.ts

@@ -0,0 +1,57 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const modelCommand = cli({
+  site: 'cursor',
+  name: 'model',
+  description: 'Get or switch the currently active AI model in Cursor',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  args: [
+    { name: 'model_name', required: false, positional: true, help: 'The ID of the model to switch to (e.g. claude-3.5-sonnet)' }
+  ],
+  columns: ['Status', 'Model'],
+  func: async (page: IPage, kwargs: any) => {
+    const desiredModel = kwargs.model_name as string | undefined;
+
+    if (!desiredModel) {
+      // Just read the current model
+      const currentModel = await page.evaluate(`
+        (function() {
+          const m = document.querySelector('.composer-unified-dropdown-model span, [class*="unifiedmodeldropdown"] span');
+          return m ? m.textContent.trim() : 'Unknown or Not Found';
+        })()
+      `);
+      
+      return [
+        {
+          Status: 'Active',
+          Model: currentModel,
+        },
+      ];
+    } else {
+      // Try to switch model (click dropdown, type/select model)
+      const success = await page.evaluate(`
+        (function(targetModel) {
+          const dropdown = document.querySelector('.composer-unified-dropdown-model, [class*="unifiedmodeldropdown"]');
+          if (!dropdown) return 'Dropdown not found';
+          
+          dropdown.click();
+          // After clicking, the DOM usually spawns a popup list.
+          // Because it's hard to predict exactly how the list renders, 
+          // a simple scriptable approach is just to click it, and hope we can select it via UI.
+          // In many React apps, clicking it opens a menu, and clicking the item works.
+          return 'Dropdown opened. Automated switching is not fully generic. Please implement precise list navigation depending on DOM.';
+        })(${JSON.stringify(desiredModel)})
+      `);
+      
+      return [
+        {
+          Status: success,
+          Model: desiredModel,
+        },
+      ];
+    }
+  },
+});

package/src/clis/cursor/new.ts

@@ -0,0 +1,32 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const newCommand = cli({
+  site: 'cursor',
+  name: 'new',
+  description: 'Start a new Cursor chat or Composer session',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  columns: ['Status'],
+  func: async (page: IPage) => {
+    const success = await page.evaluate(`
+      (function() {
+        const newChatButton = document.querySelector('[aria-label="New Chat"], [aria-label="New Chat (⌘N)"], .agent-sidebar-new-agent-button');
+        if (newChatButton) {
+            newChatButton.click();
+            return true;
+        }
+        return false;
+      })()
+    `);
+
+    if (!success) {
+      throw new Error('Could not find New Chat button in Cursor DOM.');
+    }
+
+    await page.wait(1);
+
+    return [{ Status: 'Success' }];
+  },
+});

package/src/clis/cursor/read.ts

@@ -0,0 +1,47 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const readCommand = cli({
+  site: 'cursor',
+  name: 'read',
+  description: 'Read the current Cursor chat/composer conversation history',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  columns: ['Role', 'Text'],
+  func: async (page: IPage) => {
+    const history = await page.evaluate(`
+      (function() {
+        const messages = Array.from(document.querySelectorAll('[data-message-role]'));
+        
+        if (messages.length === 0) {
+            return [];
+        }
+
+        return messages.map(msg => {
+            const role = msg.getAttribute('data-message-role');
+            let text = '';
+            
+            // Try to get structured markdown root for AI, or lexical text for human
+            const markdownRoot = msg.querySelector('.markdown-root');
+            if (markdownRoot) {
+                text = markdownRoot.innerText || markdownRoot.textContent;
+            } else {
+                text = msg.innerText || msg.textContent;
+            }
+
+            return {
+                Role: role === 'human' ? 'User' : 'Assistant',
+                Text: text.trim()
+            };
+        });
+      })()
+    `);
+
+    if (!history || history.length === 0) {
+      throw new Error('No conversation history found in Cursor.');
+    }
+
+    return history;
+  },
+});

package/src/clis/cursor/send.ts

@@ -0,0 +1,47 @@
+import { cli, Strategy } from '../../registry.js';
+import type { IPage } from '../../types.js';
+
+export const sendCommand = cli({
+  site: 'cursor',
+  name: 'send',
+  description: 'Send a prompt directly into Cursor Composer/Chat',
+  domain: 'localhost',
+  strategy: Strategy.UI,
+  browser: true,
+  args: [{ name: 'text', required: true, positional: true, help: 'Text to send into Cursor' }],
+  columns: ['Status', 'InjectedText'],
+  func: async (page: IPage, kwargs: any) => {
+    const textToInsert = kwargs.text as string;
+
+    const injected = await page.evaluate(
+      `(function(text) {
+        // Find the Lexical editor input for Composer or Chat
+        let composer = document.querySelector('.aislash-editor-input, [data-lexical-editor="true"], [contenteditable="true"]');
+        
+        if (!composer) {
+            return false;
+        }
+
+        composer.focus();
+        document.execCommand('insertText', false, text);
+        return true;
+      })(${JSON.stringify(textToInsert)})`
+    );
+
+    if (!injected) {
+      throw new Error('Could not find Cursor Composer input element.');
+    }
+
+    // Submit the command. In Cursor, Enter usually submits the chat.
+    await page.wait(0.5);
+    await page.pressKey('Enter');
+    await page.wait(1);
+
+    return [
+      {
+        Status: 'Success',
+        InjectedText: textToInsert,
+      },
+    ];
+  },
+});

package/src/clis/cursor/status.ts

@@ -0,0 +1,23 @@
+import { cli, Strategy } from '../../registry.js';
+
+export const statusCommand = cli({
+  site: 'cursor',
+  name: 'status',
+  description: 'Check active CDP connection to Cursor AI Editor',
+  domain: 'localhost',
+  strategy: Strategy.UI, // Interactive UI manipulation
+  browser: true,
+  columns: ['Status', 'Url', 'Title'],
+  func: async (page) => {
+    const url = await page.evaluate('window.location.href');
+    const title = await page.evaluate('document.title');
+
+    return [
+      {
+        Status: 'Connected',
+        Url: url,
+        Title: title,
+      },
+    ];
+  },
+});