@jackwener/opencli 1.0.0 → 1.0.1

package/README.md

@@ -22,6 +22,7 @@ Turn ANY Electron application into a CLI tool! Recombine, script, and extend app
 - [Prerequisites](#prerequisites)
 - [Quick Start](#quick-start)
 - [Built-in Commands](#built-in-commands)
+  - [Desktop App Adapters](#desktop-app-adapters)
 - [Download Support](#download-support)
 - [Output Formats](#output-formats)
 - [For AI Agents (Developer Guide)](#for-ai-agents-developer-guide)
@@ -106,7 +107,7 @@ Run `opencli list` for the live registry.
 
 | Site | Commands | Mode |
 |------|----------|------|
-| **twitter** | `trending` `bookmarks` `profile` `search` `timeline` `thread` `following` `followers` `notifications` `post` `reply` `delete` `like` `article` `follow` `unfollow` `bookmark` `unbookmark` `download` | 🔐 Browser |
+| **twitter** | `trending` `bookmarks` `profile` `search` `timeline` `thread` `following` `followers` `notifications` `post` `reply` `delete` `like` `article` `follow` `unfollow` `bookmark` `unbookmark` `download` `accept` `reply-dm` | 🔐 Browser |
 | **reddit** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` | 🔐 Browser |
 | **cursor** | `status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export` | 🖥️ Desktop |
 | **bilibili** | `hot` `search` `me` `favorite` `history` `feed` `subtitle` `dynamic` `ranking` `following` `user-videos` `download` | 🔐 Browser |
@@ -119,6 +120,7 @@ Run `opencli list` for the live registry.
 | **antigravity** | `status` `send` `read` `new` `evaluate` | 🖥️ Desktop |
 | **chatgpt** | `status` `new` `send` `read` `ask` | 🖥️ Desktop |
 | **xiaohongshu** | `search` `notifications` `feed` `me` `user` `download` | 🔐 Browser |
+| **apple-podcasts** | `search` `episodes` `top` | 🌐 Public |
 | **xiaoyuzhou** | `podcast` `podcast-episodes` `episode` | 🌐 Public |
 | **zhihu** | `hot` `search` `question` `download` | 🔐 Browser |
 | **youtube** | `search` `video` `transcript` | 🔐 Browser |
@@ -134,6 +136,23 @@ Run `opencli list` for the live registry.
 | **weibo** | `hot` | 🔐 Browser |
 | **yahoo-finance** | `quote` | 🔐 Browser |
 
+### Desktop App Adapters
+
+Each desktop adapter has its own detailed documentation with commands reference, setup guide, and examples:
+
+| App | Description | Doc |
+|-----|-------------|-----|
+| **Cursor** | Control Cursor IDE — Composer, chat, code extraction | [README](./src/clis/cursor/README.md) |
+| **Codex** | Drive OpenAI Codex CLI agent headlessly | [README](./src/clis/codex/README.md) |
+| **Antigravity** | Control Antigravity Ultra from terminal | [README](./src/clis/antigravity/README.md) |
+| **ChatGPT** | Automate ChatGPT macOS desktop app | [README](./src/clis/chatgpt/README.md) |
+| **ChatWise** | Multi-LLM client (GPT-4, Claude, Gemini) | [README](./src/clis/chatwise/README.md) |
+| **Notion** | Search, read, write Notion pages | [README](./src/clis/notion/README.md) |
+| **Discord** | Discord Desktop — messages, channels, servers | [README](./src/clis/discord-app/README.md) |
+| **Feishu** | 飞书/Lark Desktop via AppleScript | [README](./src/clis/feishu/README.md) |
+| **WeChat** | 微信 Desktop via AppleScript + Accessibility | [README](./src/clis/wechat/README.md) |
+| **NeteaseMusic** | 网易云音乐 Desktop via CEF/CDP | [README](./src/clis/neteasemusic/README.md) |
+
 ## Download Support
 
 OpenCLI supports downloading images, videos, and articles from supported platforms.

package/README.zh-CN.md

@@ -24,6 +24,7 @@ CLI all electron！现在支持把所有 electron 应用 CLI 化，从而组合
 - [前置要求](#前置要求)
 - [快速开始](#快速开始)
 - [内置命令](#内置命令)
+  - [桌面应用适配器](#桌面应用适配器)
 - [下载支持](#下载支持)
 - [输出格式](#输出格式)
 - [致 AI Agent（开发者指南）](#致-ai-agent开发者指南)
@@ -107,7 +108,7 @@ 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` `download` | 🔐 浏览器 |
+| **twitter** | `trending` `bookmarks` `profile` `search` `timeline` `thread` `following` `followers` `notifications` `post` `reply` `delete` `like` `article` `follow` `unfollow` `bookmark` `unbookmark` `download` `accept` `reply-dm` | 🔐 浏览器 |
 | **reddit** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` | 🔐 浏览器 |
 | **cursor** | `status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export` | 🖥️ 桌面端 |
 | **bilibili** | `hot` `search` `me` `favorite` `history` `feed` `subtitle` `dynamic` `ranking` `following` `user-videos` `download` | 🔐 浏览器 |
@@ -120,6 +121,7 @@ npm install -g @jackwener/opencli@latest
 | **antigravity** | `status` `send` `read` `new` `evaluate` | 🖥️ 桌面端 |
 | **chatgpt** | `status` `new` `send` `read` `ask` | 🖥️ 桌面端 |
 | **xiaohongshu** | `search` `notifications` `feed` `me` `user` `download` | 🔐 浏览器 |
+| **apple-podcasts** | `search` `episodes` `top` | 🌐 公开 |
 | **xiaoyuzhou** | `podcast` `podcast-episodes` `episode` | 🌐 公开 |
 | **zhihu** | `hot` `search` `question` `download` | 🔐 浏览器 |
 | **youtube** | `search` `video` `transcript` | 🔐 浏览器 |
@@ -135,6 +137,23 @@ npm install -g @jackwener/opencli@latest
 | **weibo** | `hot` | 🔐 浏览器 |
 | **yahoo-finance** | `quote` | 🔐 浏览器 |
 
+### 桌面应用适配器
+
+每个桌面适配器都有自己详细的文档说明，包括命令参考、启动配置与使用示例：
+
+| 应用 | 描述 | 文档 |
+|-----|-------------|-----|
+| **Cursor** | 控制 Cursor IDE — Composer、对话、代码提取等 | [README](./src/clis/cursor/README.md) |
+| **Codex** | 在后台（无头）驱动 OpenAI Codex CLI Agent | [README](./src/clis/codex/README.md) |
+| **Antigravity** | 在终端直接控制 Antigravity Ultra | [README](./src/clis/antigravity/README.md) |
+| **ChatGPT** | 自动化操作 ChatGPT macOS 桌面客户端 | [README](./src/clis/chatgpt/README.md) |
+| **ChatWise** | 多 LLM 客户端（GPT-4、Claude、Gemini） | [README](./src/clis/chatwise/README.md) |
+| **Notion** | 搜索、读取、写入 Notion 页面 | [README](./src/clis/notion/README.md) |
+| **Discord** | Discord 桌面版 — 消息、频道、服务器 | [README](./src/clis/discord-app/README.md) |
+| **Feishu** | 飞书/Lark 桌面版 (AppleScript 驱动) | [README](./src/clis/feishu/README.md) |
+| **WeChat** | 微信 Mac 桌面端 (AppleScript + 无障碍接口) | [README](./src/clis/wechat/README.md) |
+| **NeteaseMusic** | 网易云音乐 (CEF/CDP 驱动) | [README](./src/clis/neteasemusic/README.md) |
+
 ## 下载支持
 
 OpenCLI 支持从各平台下载图片、视频和文章。

package/dist/browser/daemon-client.d.ts

@@ -5,7 +5,7 @@
  */
 export interface DaemonCommand {
     id: string;
-    action: 'exec' | 'navigate' | 'tabs' | 'cookies' | 'screenshot';
+    action: 'exec' | 'navigate' | 'tabs' | 'cookies' | 'screenshot' | 'close-window';
     tabId?: number;
     code?: string;
     url?: string;

package/dist/browser/index.d.ts

@@ -5,9 +5,8 @@
  * External code should import from './browser/index.js' (or './browser.js' via Node resolution).
  */
 export { Page } from './page.js';
-export { PlaywrightMCP } from './mcp.js';
+export { BrowserBridge, BrowserBridge as PlaywrightMCP } from './mcp.js';
 export { isDaemonRunning } from './daemon-client.js';
-export declare function getTokenFingerprint(_token: string | undefined): string | null;
 import { extractTabEntries, diffTabIndexes, appendLimited } from './tabs.js';
 import { withTimeoutMs } from '../runtime.js';
 export declare const __test__: {

package/dist/browser/index.js

@@ -5,12 +5,8 @@
  * External code should import from './browser/index.js' (or './browser.js' via Node resolution).
  */
 export { Page } from './page.js';
-export { PlaywrightMCP } from './mcp.js';
+export { BrowserBridge, BrowserBridge as PlaywrightMCP } from './mcp.js';
 export { isDaemonRunning } from './daemon-client.js';
-// Backward compatibility: getTokenFingerprint is no longer needed but kept as no-op export
-export function getTokenFingerprint(_token) {
-    return null;
-}
 import { extractTabEntries, diffTabIndexes, appendLimited } from './tabs.js';
 import { withTimeoutMs } from '../runtime.js';
 export const __test__ = {

package/dist/browser/mcp.d.ts

@@ -1,24 +1,21 @@
 /**
  * Browser session manager — auto-spawns daemon and provides IPage.
- *
- * Replaces the old PlaywrightMCP class. Still exports as PlaywrightMCP
- * for backward compatibility with main.ts and other consumers.
  */
 import type { IPage } from '../types.js';
-export type PlaywrightMCPState = 'idle' | 'connecting' | 'connected' | 'closing' | 'closed';
+export type BrowserBridgeState = 'idle' | 'connecting' | 'connected' | 'closing' | 'closed';
 /**
  * Browser factory: manages daemon lifecycle and provides IPage instances.
- *
- * Kept as `PlaywrightMCP` class name for backward compatibility.
  */
-export declare class PlaywrightMCP {
+export declare class BrowserBridge {
     private _state;
     private _page;
     private _daemonProc;
-    get state(): PlaywrightMCPState;
+    get state(): BrowserBridgeState;
     connect(opts?: {
         timeout?: number;
     }): Promise<IPage>;
     close(): Promise<void>;
     private _ensureDaemon;
 }
+/** @deprecated Use BrowserBridge instead */
+export declare const PlaywrightMCP: typeof BrowserBridge;

package/dist/browser/mcp.js

@@ -1,8 +1,5 @@
 /**
  * Browser session manager — auto-spawns daemon and provides IPage.
- *
- * Replaces the old PlaywrightMCP class. Still exports as PlaywrightMCP
- * for backward compatibility with main.ts and other consumers.
  */
 import { spawn } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
@@ -13,10 +10,8 @@ import { isDaemonRunning, isExtensionConnected } from './daemon-client.js';
 const DAEMON_SPAWN_TIMEOUT = 10000; // 10s to wait for daemon + extension
 /**
  * Browser factory: manages daemon lifecycle and provides IPage instances.
- *
- * Kept as `PlaywrightMCP` class name for backward compatibility.
  */
-export class PlaywrightMCP {
+export class BrowserBridge {
     _state = 'idle';
     _page = null;
     _daemonProc = null;
@@ -68,10 +63,12 @@ export class PlaywrightMCP {
         if (process.env.OPENCLI_VERBOSE) {
             console.error(`[opencli] Starting daemon (${isTs ? 'ts' : 'js'})...`);
         }
-        // Use the current runtime to spawn daemon — avoids slow npx resolution.
-        // If already running under tsx (dev), process.execPath is tsx's node.
-        // If running compiled (node dist/), process.execPath is node.
-        this._daemonProc = spawn(process.execPath, [daemonPath], {
+        // For compiled .js, use the current node binary directly (fast).
+        // For .ts dev mode, node can't run .ts files — use tsx via --import.
+        const spawnArgs = isTs
+            ? [process.execPath, '--import', 'tsx/esm', daemonPath]
+            : [process.execPath, daemonPath];
+        this._daemonProc = spawn(spawnArgs[0], spawnArgs.slice(1), {
             detached: true,
             stdio: 'ignore',
             env: { ...process.env },
@@ -94,3 +91,5 @@ export class PlaywrightMCP {
             'Make sure port 19825 is available.');
     }
 }
+/** @deprecated Use BrowserBridge instead */
+export const PlaywrightMCP = BrowserBridge;

package/dist/browser/page.d.ts

@@ -19,6 +19,8 @@ export declare class Page implements IPage {
     /** Helper: spread tabId into command params if we have one */
     private _tabOpt;
     goto(url: string): Promise<void>;
+    /** Close the automation window in the extension */
+    closeWindow(): Promise<void>;
     evaluate(js: string): Promise<any>;
     snapshot(opts?: {
         interactive?: boolean;
@@ -39,7 +41,12 @@ export declare class Page implements IPage {
     newTab(): Promise<void>;
     selectTab(index: number): Promise<void>;
     networkRequests(includeStatic?: boolean): Promise<any>;
-    consoleMessages(level?: string): Promise<any>;
+    /**
+     * Console messages are not available in lightweight daemon mode.
+     * Would require CDP Runtime.consoleAPICalled event listener.
+     * @returns Always returns empty array.
+     */
+    consoleMessages(_level?: string): Promise<any>;
     /**
      * Capture a screenshot via CDP Page.captureScreenshot.
      * @param options.format - 'png' (default) or 'jpeg'

package/dist/browser/page.js

@@ -31,6 +31,15 @@ export class Page {
             this._tabId = result.tabId;
         }
     }
+    /** Close the automation window in the extension */
+    async closeWindow() {
+        try {
+            await sendCommand('close-window', {});
+        }
+        catch {
+            // Window may already be closed or daemon may be down
+        }
+    }
     async evaluate(js) {
         const code = wrapForEval(js);
         return sendCommand('exec', { code, ...this._tabOpt() });
@@ -168,12 +177,12 @@ export class Page {
     `;
         return sendCommand('exec', { code, ...this._tabOpt() });
     }
-    async consoleMessages(level = 'info') {
-        // Console messages can't be retrospectively read via CDP Runtime.evaluate.
-        // Would need Runtime.consoleAPICalled event listener, which is not yet implemented.
-        if (process.env.OPENCLI_VERBOSE) {
-            console.error('[page] consoleMessages() not supported in lightweight mode — returning empty');
-        }
+    /**
+     * Console messages are not available in lightweight daemon mode.
+     * Would require CDP Runtime.consoleAPICalled event listener.
+     * @returns Always returns empty array.
+     */
+    async consoleMessages(_level = 'info') {
         return [];
     }
     /**
@@ -234,20 +243,17 @@ export class Page {
     }
     async installInterceptor(pattern) {
         const { generateInterceptorJs } = await import('../interceptor.js');
-        await sendCommand('exec', {
-            code: generateInterceptorJs(JSON.stringify(pattern), {
-                arrayName: '__opencli_xhr',
-                patchGuard: '__opencli_interceptor_patched',
-            }),
-            ...this._tabOpt(),
-        });
+        // Must use evaluate() so wrapForEval() converts the arrow function into an IIFE;
+        // sendCommand('exec') sends the code as-is, and CDP never executes a bare arrow.
+        await this.evaluate(generateInterceptorJs(JSON.stringify(pattern), {
+            arrayName: '__opencli_xhr',
+            patchGuard: '__opencli_interceptor_patched',
+        }));
     }
     async getInterceptedRequests() {
         const { generateReadInterceptedJs } = await import('../interceptor.js');
-        const result = await sendCommand('exec', {
-            code: generateReadInterceptedJs('__opencli_xhr'),
-            ...this._tabOpt(),
-        });
+        // Same as installInterceptor: must go through evaluate() for IIFE wrapping
+        const result = await this.evaluate(generateReadInterceptedJs('__opencli_xhr'));
         return result || [];
     }
 }

package/dist/browser.test.js

@@ -1,5 +1,5 @@
 import { describe, it, expect } from 'vitest';
-import { PlaywrightMCP, __test__ } from './browser/index.js';
+import { BrowserBridge, __test__ } from './browser/index.js';
 describe('browser helpers', () => {
     it('extracts tab entries from string snapshots', () => {
         const entries = __test__.extractTabEntries('Tab 0 https://example.com\nTab 1 Chrome Extension');
@@ -31,25 +31,25 @@ describe('browser helpers', () => {
         await expect(__test__.withTimeoutMs(new Promise(() => { }), 10, 'timeout')).rejects.toThrow('timeout');
     });
 });
-describe('PlaywrightMCP state', () => {
+describe('BrowserBridge state', () => {
     it('transitions to closed after close()', async () => {
-        const mcp = new PlaywrightMCP();
+        const mcp = new BrowserBridge();
         expect(mcp.state).toBe('idle');
         await mcp.close();
         expect(mcp.state).toBe('closed');
     });
     it('rejects connect() after the session has been closed', async () => {
-        const mcp = new PlaywrightMCP();
+        const mcp = new BrowserBridge();
         await mcp.close();
         await expect(mcp.connect()).rejects.toThrow('Session is closed');
     });
     it('rejects connect() while already connecting', async () => {
-        const mcp = new PlaywrightMCP();
+        const mcp = new BrowserBridge();
         mcp._state = 'connecting';
         await expect(mcp.connect()).rejects.toThrow('Already connecting');
     });
     it('rejects connect() while closing', async () => {
-        const mcp = new PlaywrightMCP();
+        const mcp = new BrowserBridge();
         mcp._state = 'closing';
         await expect(mcp.connect()).rejects.toThrow('Session is closing');
     });