@jackwener/opencli 0.9.8 → 1.0.1

package/CDP.md

@@ -1,6 +1,6 @@
 # Connecting OpenCLI via CDP (Remote/Headless Servers)
 
-If you cannot use the Playwright MCP Bridge extension (e.g., in a remote headless server environment without a UI), OpenCLI provides an alternative: connecting directly to Chrome via **CDP (Chrome DevTools Protocol)**.
+If you cannot use the opencli Browser Bridge extension (e.g., in a remote headless server environment without a UI), OpenCLI provides an alternative: connecting directly to Chrome via **CDP (Chrome DevTools Protocol)**.
 
 Because CDP binds to `localhost` by default for security reasons, accessing it from a remote server requires an additional networking tunnel.
 

package/CDP.zh-CN.md

@@ -1,6 +1,6 @@
 # 通过 CDP 远程连接 OpenCLI (服务器/无头环境)
 
-如果你无法使用 Playwright MCP Bridge 浏览器扩展（例如：在无界面的远程服务器上运行 OpenCLI 时），OpenCLI 提供了备选方案：通过连接 **CDP (Chrome DevTools Protocol，即 Chrome 开发者工具协议)** 来直接控制本地 Chrome。
+如果你无法使用 opencli Browser Bridge 浏览器扩展（例如：在无界面的远程服务器上运行 OpenCLI 时），OpenCLI 提供了备选方案：通过连接 **CDP (Chrome DevTools Protocol，即 Chrome 开发者工具协议)** 来直接控制本地 Chrome。
 
 出于安全考虑，CDP 默认仅绑定在 `localhost` 的本地端口。所以，若是想让**远程服务器**调用本地的 CDP 服务，我们需要依靠一层额外的网络隧道。
 

package/CLI-ELECTRON.md

@@ -8,7 +8,7 @@ Based on the successful automation of **Cursor**, **Codex**, **Antigravity**, **
 
 ## Core Concept
 
-Electron apps are essentially local Chromium browser instances. By exposing a debugging port (CDP — Chrome DevTools Protocol) at launch time, we can use Playwright to pierce through the UI layer, accessing and controlling all underlying state including React/Vue components and Shadow DOM.
+Electron apps are essentially local Chromium browser instances. By exposing a debugging port (CDP — Chrome DevTools Protocol) at launch time, we can use the Browser Bridge to pierce through the UI layer, accessing and controlling all underlying state including React/Vue components and Shadow DOM.
 
 > **Note:** Not all desktop apps are Electron. WeChat (native Cocoa) and Feishu/Lark (custom Lark Framework) embed Chromium but do NOT expose CDP. For those apps, use the AppleScript + clipboard approach instead (see [Non-Electron Pattern](#non-electron-pattern-applescript)).
 
@@ -109,7 +109,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, Notion=9230, Discord=9232
-2. **IPage abstraction**: OpenCLI wraps Playwright Page as `IPage` (`src/types.ts`). Use `page.pressKey()` and `page.evaluate()`, NOT `page.keyboard.press()`
+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
 

package/CLI-EXPLORER.md

@@ -9,12 +9,12 @@
 
 ---
 
-## AI Agent 开发者必读：用 Playwright MCP Bridge 探索
+## AI Agent 开发者必读：用浏览器探索
 
 > [!CAUTION]
-> **你（AI Agent）必须通过 Playwright MCP Bridge 打开浏览器去访问目标网站！**  
+> **你（AI Agent）必须通过浏览器打开目标网站去探索！**  
 > 不要只靠 `opencli explore` 命令或静态分析来发现 API。  
-> 你拥有 Playwright MCP 工具，必须主动用它们浏览网页、观察网络请求、模拟用户交互。
+> 你拥有浏览器工具，必须主动用它们浏览网页、观察网络请求、模拟用户交互。
 
 ### 为什么？
 
@@ -36,7 +36,7 @@
 
 | ❌ 错误做法 | ✅ 正确做法 |
 |------------|------------|
-| 只用 `opencli explore` 命令，等结果自动出来 | 用 MCP Bridge 打开浏览器，主动浏览页面 |
+| 只用 `opencli explore` 命令，等结果自动出来 | 用浏览器工具打开页面，主动浏览 |
 | 直接在代码里 `fetch(url)`，不看浏览器实际请求 | 先在浏览器中确认 API 可用，再写代码 |
 | 页面打开后直接抓包，期望所有 API 都出现 | 模拟点击交互（展开评论/切换标签/加载更多） |
 | 遇到 HTTP 200 但空数据就放弃 | 检查是否需要 Wbi 签名或 Cookie 鉴权 |

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)
@@ -49,69 +50,27 @@ Turn ANY Electron application into a CLI tool! Recombine, script, and extend app
 
 > **⚠️ Important**: Browser commands reuse your Chrome login session. You must be logged into the target website in Chrome before running commands. If you get empty data or errors, check your login status first.
 
-OpenCLI connects to your browser through the Playwright MCP Bridge extension.
-It prefers an existing local/global `@playwright/mcp` install and falls back to `npx -y @playwright/mcp@latest` automatically when no local MCP server is found.
+OpenCLI connects to your browser through a lightweight **Browser Bridge** Chrome Extension + micro-daemon (zero config, auto-start).
 
-### Playwright MCP Bridge Extension Setup
+### Browser Bridge Extension Setup
 
-1. Install **[Playwright MCP Bridge](https://chromewebstore.google.com/detail/playwright-mcp-bridge/mmlmfjhmonkocbjadbfplnigmagldckm)** extension in Chrome.
-2. Run `opencli setup` — discovers the token, distributes it to your tools, and verifies connectivity:
+1. Install the **opencli Browser Bridge** extension in Chrome:
+   - Open `chrome://extensions`, enable **Developer mode** (top-right toggle)
+   - Click **Load unpacked**, select the `extension/` folder from this repo
+2. That's it! The daemon auto-starts when you run any browser command. No tokens, no manual configuration.
 
-```bash
-opencli setup
-```
-
-The interactive TUI will:
-- 🔍 Auto-discover `PLAYWRIGHT_MCP_EXTENSION_TOKEN` from Chrome (no manual copy needed)
-- ☑️ Show all detected tools (Codex, Cursor, Claude Code, Gemini CLI, etc.)
-- ✏️ Update only the files you select (Space to toggle, Enter to confirm)
-- 🔌 Auto-verify browser connectivity after writing configs
-
-> **Tip**: Use `opencli doctor` for ongoing diagnosis and maintenance:
+> **Tip**: Use `opencli doctor` for ongoing diagnosis:
 > ```bash
-> opencli doctor            # Read-only token & config diagnosis
-> opencli doctor --live     # Also test live browser connectivity
-> opencli doctor --fix      # Fix mismatched configs (interactive)
-> opencli doctor --fix -y   # Fix all configs non-interactively
+> opencli doctor            # Check extension + daemon connectivity
+> opencli doctor --live     # Also test live browser commands
 > ```
 
-**Alternative: CDP Mode (For Servers/Headless)**
-If you cannot install the browser extension (e.g. running OpenCLI on a remote headless server), you can connect OpenCLI to your local Chrome via CDP using SSH tunnels or reverse proxies. See the [CDP Connection Guide](./CDP.md) for detailed instructions.
-
-<details>
-<summary>Manual setup (alternative)</summary>
-
-Add token to your MCP client config (e.g. Claude/Cursor):
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": ["-y", "@playwright/mcp@latest", "--extension"],
-      "env": {
-        "PLAYWRIGHT_MCP_EXTENSION_TOKEN": "<your-token-here>"
-      }
-    }
-  }
-}
-```
-
-Export in shell (e.g. `~/.zshrc`):
-
-```bash
-export PLAYWRIGHT_MCP_EXTENSION_TOKEN="<your-token-here>"
-```
-
-</details>
-
 ## Quick Start
 
 ### Install via npm (recommended)
 
 ```bash
 npm install -g @jackwener/opencli
-opencli setup   # One-time: configure Playwright MCP token
 ```
 
 Then use directly:
@@ -148,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 |
@@ -161,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 |
@@ -176,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.
@@ -297,15 +274,15 @@ npx vitest run tests/e2e/                    # E2E tests
 
 ## Troubleshooting
 
-- **"Failed to connect to Playwright MCP Bridge"**
-  - Ensure the Playwright MCP extension is installed and **enabled** in your running Chrome.
-  - Restart the Chrome browser if you just installed the extension.
+- **"Extension not connected"**
+  - Ensure the opencli Browser Bridge extension is installed and **enabled** in `chrome://extensions`.
 - **Empty data returns or 'Unauthorized' error**
-  - Your login session in Chrome might have expired. Open a normal Chrome tab, navigate to the target site, and log in or refresh the page to prove you are human.
+  - Your login session in Chrome might have expired. Open a normal Chrome tab, navigate to the target site, and log in or refresh the page.
 - **Node API errors**
   - Make sure you are using Node.js >= 20. Some dependencies require modern Node APIs.
-- **Token issues**
-  - Run `opencli doctor` to diagnose token configuration across all tools.
+- **Daemon issues**
+  - Check daemon status: `curl localhost:19825/status`
+  - View extension logs: `curl localhost:19825/logs`
 
 ## Releasing New Versions
 

package/README.zh-CN.md

@@ -24,6 +24,7 @@ CLI all electron！现在支持把所有 electron 应用 CLI 化，从而组合
 - [前置要求](#前置要求)
 - [快速开始](#快速开始)
 - [内置命令](#内置命令)
+  - [桌面应用适配器](#桌面应用适配器)
 - [下载支持](#下载支持)
 - [输出格式](#输出格式)
 - [致 AI Agent（开发者指南）](#致-ai-agent开发者指南)
@@ -50,69 +51,27 @@ CLI all electron！现在支持把所有 electron 应用 CLI 化，从而组合
 
 > **⚠️ 重要**：大多数命令复用你的 Chrome 登录状态。运行命令前，你必须已在 Chrome 中打开目标网站并完成登录。如果获取到空数据或报错，请先检查你的浏览器登录状态。
 
-OpenCLI 通过 Playwright MCP Bridge 扩展与你的浏览器通信。
-它会优先复用本地或全局已安装的 `@playwright/mcp`，如果没有嗅探到可用 MCP server，则会自动回退到 `npx -y @playwright/mcp@latest` 启动。
+OpenCLI 通过轻量化的 **Browser Bridge** Chrome 扩展 + 微型 daemon 与浏览器通信（零配置，自动启动）。
 
-### Playwright MCP Bridge 扩展配置
+### Browser Bridge 扩展配置
 
-1. 安装 **[Playwright MCP Bridge](https://chromewebstore.google.com/detail/playwright-mcp-bridge/mmlmfjhmonkocbjadbfplnigmagldckm)** 扩展
-2. 运行 `opencli setup` — 自动发现 Token、分发到各工具、验证连通性：
+1. 在 Chrome 中安装 **opencli Browser Bridge** 扩展：
+   - 打开 `chrome://extensions`，启用右上角的 **开发者模式**
+   - 点击 **加载已解压的扩展程序**，选择本仓库的 `extension/` 文件夹
+2. 完成！运行任何浏览器命令时 daemon 会自动启动。无需 token，无需手动配置。
 
-```bash
-opencli setup
-```
-
-交互式 TUI 会：
-- 🔍 从 Chrome 自动发现 `PLAYWRIGHT_MCP_EXTENSION_TOKEN`（无需手动复制）
-- ☑️ 显示所有支持的工具（Codex、Cursor、Claude Code、Gemini CLI 等）
-- ✏️ 只更新你选中的文件（空格切换，回车确认）
-- 🔌 完成后自动验证浏览器连通性
-
-> **Tip**：后续诊断和维护用 `opencli doctor`：
+> **Tip**：后续诊断用 `opencli doctor`：
 > ```bash
-> opencli doctor            # 只读 Token 与配置诊断
-> opencli doctor --live     # 额外测试浏览器连通性
-> opencli doctor --fix      # 修复不一致的配置（交互确认）
-> opencli doctor --fix -y   # 无交互直接修复所有配置
+> opencli doctor            # 检查扩展和 daemon 连通性
+> opencli doctor --live     # 额外测试浏览器命令
 > ```
 
-**备选方案：CDP 模式 (适用于服务器/无头环境)**
-如果你无法安装浏览器扩展（比如在远程无头服务器上运行 OpenCLI），你可以通过 SSH 隧道或反向代理，利用 CDP (Chrome DevTools Protocol) 连接到本地的 Chrome 浏览器。详细指南请参考 [CDP 连接教程](./CDP.zh-CN.md)。
-
-<details>
-<summary>手动配置（备选方案）</summary>
-
-配置你的 MCP 客户端（如 Claude/Cursor 等）：
-
-```json
-{
-  "mcpServers": {
-    "playwright": {
-      "command": "npx",
-      "args": ["-y", "@playwright/mcp@latest", "--extension"],
-      "env": {
-        "PLAYWRIGHT_MCP_EXTENSION_TOKEN": "<你的-token>"
-      }
-    }
-  }
-}
-```
-
-在终端环境变量中导出（建议写进 `~/.zshrc`）：
-
-```bash
-export PLAYWRIGHT_MCP_EXTENSION_TOKEN="<你的-token>"
-```
-
-</details>
-
 ## 快速开始
 
 ### npm 全局安装（推荐）
 
 ```bash
 npm install -g @jackwener/opencli
-opencli setup   # 首次使用：配置 Playwright MCP token
 ```
 
 直接使用：
@@ -149,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` | 🔐 浏览器 |
@@ -162,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` | 🔐 浏览器 |
@@ -177,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 支持从各平台下载图片、视频和文章。
@@ -280,16 +257,15 @@ opencli cascade https://api.example.com/data
 
 ## 常见问题排查
 
-- **"Failed to connect to Playwright MCP Bridge"** 报错
-  - 确保你当前的 Chrome 已安装且**开启了** Playwright MCP Bridge 浏览器插件。
-  - 如果是刚装完插件，需要重启 Chrome 浏览器。
+- **"Extension not connected" 报错**
+  - 确保你当前的 Chrome 已安装且**开启了** opencli Browser Bridge 扩展（在 `chrome://extensions` 中检查）。
 - **返回空数据，或者报错 "Unauthorized"**
-  - Chrome 里的登录态可能已经过期（甚至被要求过滑动验证码）。请打开当前 Chrome 页面，在新标签页重新手工登录或刷新该页面。
+  - Chrome 里的登录态可能已经过期。请打开当前 Chrome 页面，在新标签页重新手工登录或刷新该页面。
 - **Node API 错误 (如 parseArgs, fs 等)**
-  - 确保 Node.js 版本 `>= 20`。旧版不支持我们使用的现代核心库 API。
-- **Token 问题**
-  - 运行 `opencli doctor` 诊断所有工具的 Token 配置状态。
-  - 使用 `opencli doctor --live` 测试浏览器连通性。
+  - 确保 Node.js 版本 `>= 20`。
+- **Daemon 问题**
+  - 检查 daemon 状态：`curl localhost:19825/status`
+  - 查看扩展日志：`curl localhost:19825/logs`
 
 ## 版本发布
 

package/SKILL.md

@@ -3,7 +3,7 @@ name: opencli
 description: "OpenCLI — Make any website or Electron App your CLI. Zero risk, AI-powered, reuse Chrome login. 80+ commands across 19 sites."
 version: 0.7.3
 author: jackwener
-tags: [cli, browser, web, mcp, playwright, bilibili, zhihu, twitter, github, v2ex, hackernews, reddit, xiaohongshu, xueqiu, youtube, boss, coupang, AI, agent]
+tags: [cli, browser, web, chrome-extension, cdp, bilibili, zhihu, twitter, github, v2ex, hackernews, reddit, xiaohongshu, xueqiu, youtube, boss, coupang, AI, agent]
 ---
 
 # OpenCLI
@@ -12,7 +12,7 @@ tags: [cli, browser, web, mcp, playwright, bilibili, zhihu, twitter, github, v2e
 
 > [!CAUTION]
 > **AI Agent 必读：创建或修改任何适配器之前，你必须先阅读 [CLI-EXPLORER.md](./CLI-EXPLORER.md)！**
-> 该文档包含完整的 API 发现工作流（必须使用 Playwright MCP Bridge 浏览器探索）、5 级认证策略决策树、平台 SDK 速查表、`tap` 步骤调试流程、分页 API 模板、级联请求模式、以及常见陷阱。
+> 该文档包含完整的 API 发现工作流（必须使用浏览器探索）、5 级认证策略决策树、平台 SDK 速查表、`tap` 步骤调试流程、分页 API 模板、级联请求模式、以及常见陷阱。
 > **本文件（SKILL.md）仅提供命令参考和简化模板，不足以正确开发适配器。**
 
 ## Install & Run
@@ -34,8 +34,8 @@ npm update -g @jackwener/opencli
 
 Browser commands require:
 1. Chrome browser running **(logged into target sites)**
-2. [Playwright MCP Bridge](https://chromewebstore.google.com/detail/playwright-mcp-bridge/mmlmfjhmonkocbjadbfplnigmagldckm) extension installed
-3. Run `opencli setup` to auto-discover token and configure all tools
+2. **opencli Browser Bridge** Chrome extension installed (load `extension/` as unpacked in `chrome://extensions`)
+3. No further setup needed — the daemon auto-starts on first browser command
 
 > **Note**: You must be logged into the target website in Chrome before running commands. Tabs opened during command execution are auto-closed afterwards.
 
@@ -227,7 +227,7 @@ opencli bilibili hot -v         # Show each pipeline step and data flow
 
 > [!IMPORTANT]
 > **完整模式 — 在写任何代码之前，先阅读 [CLI-EXPLORER.md](./CLI-EXPLORER.md)。**
-> 它包含：① AI Agent 浏览器探索工作流（必须用 Playwright MCP 抓包验证 API）② 认证策略决策树 ③ 平台 SDK（如 Bilibili 的 `apiGet`/`fetchJson`）④ YAML vs TS 选择指南 ⑤ `tap` 步骤调试方法 ⑥ 级联请求模板 ⑦ 常见陷阱表。
+> 它包含：① AI Agent 浏览器探索工作流 ② 认证策略决策树 ③ 平台 SDK（如 Bilibili 的 `apiGet`/`fetchJson`）④ YAML vs TS 选择指南 ⑤ `tap` 步骤调试方法 ⑥ 级联请求模板 ⑦ 常见陷阱表。
 > **下方仅为简化模板参考，直接使用极易踩坑。**
 
 ### YAML Pipeline (declarative, recommended)
@@ -374,16 +374,18 @@ ${{ index + 1 }}
 
 | Variable | Default | Description |
 |----------|---------|-------------|
+| `OPENCLI_DAEMON_PORT` | 19825 | Daemon listen port |
 | `OPENCLI_BROWSER_CONNECT_TIMEOUT` | 30 | Browser connection timeout (sec) |
 | `OPENCLI_BROWSER_COMMAND_TIMEOUT` | 45 | Command execution timeout (sec) |
 | `OPENCLI_BROWSER_EXPLORE_TIMEOUT` | 120 | Explore timeout (sec) |
-| `PLAYWRIGHT_MCP_EXTENSION_TOKEN` | — | Auto-approve extension connection |
+| `OPENCLI_VERBOSE` | — | Show daemon/extension logs |
 
 ## Troubleshooting
 
 | Issue | Solution |
 |-------|----------|
 | `npx not found` | Install Node.js: `brew install node` |
-| `Timed out connecting to browser` | 1) Chrome must be open 2) Install MCP Bridge extension and configure token |
+| `Extension not connected` | 1) Chrome must be open 2) Install opencli Browser Bridge extension |
 | `Target page context` error | Add `navigate:` step before `evaluate:` in YAML |
-| Empty table data | Check if evaluate returns JSON string (MCP parsing) or data path is wrong |
+| Empty table data | Check if evaluate returns correct data path |
+| Daemon issues | `curl localhost:19825/status` to check, `curl localhost:19825/logs` for extension logs |

package/TESTING.md

@@ -105,10 +105,10 @@ npx vitest src/
 
 ### 浏览器命令本地测试须知
 
-- 无 `PLAYWRIGHT_MCP_EXTENSION_TOKEN` 时，opencli 自动启动一个独立浏览器实例
+- opencli 通过 Browser Bridge 扩展连接已运行的 Chrome 浏览器
 - `browser-public.test.ts` 使用 `tryBrowserCommand()`，站点反爬导致空数据时 warn + pass
 - `browser-auth.test.ts` 验证 **graceful failure**（不 crash 不 hang 即通过）
-- 如需测试完整登录态，保持 Chrome 登录态 + 设置 `PLAYWRIGHT_MCP_EXTENSION_TOKEN`，手动跑对应测试
+- 如需测试完整登录态，保持 Chrome 登录态并安装 Browser Bridge 扩展，手动跑对应测试
 
 ---
 
@@ -202,12 +202,12 @@ steps:
 
 ## 浏览器模式
 
-opencli 根据 `PLAYWRIGHT_MCP_EXTENSION_TOKEN` 环境变量自动选择模式：
+opencli 通过 Browser Bridge 扩展连接浏览器：
 
-| 条件 | 模式 | MCP 参数 | 使用场景 |
-|---|---|---|---|
-| Token 已设置 | Extension 模式 | `--extension` | 本地用户，连接已登录的 Chrome |
-| Token 未设置 | Standalone 模式 | （无特殊 flag） | CI 或无扩展环境，自启浏览器 |
+| 条件 | 模式 | 使用场景 |
+|---|---|---|
+| 扩展已安装 | Extension 模式 | 本地用户，连接已登录的 Chrome |
+| 扩展未安装 | CLI 报错提示安装 | 需要安装 Browser Bridge 扩展 |
 
 CI 中使用 `OPENCLI_BROWSER_EXECUTABLE_PATH` 指定真实 Chrome 路径：
 

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

@@ -0,0 +1,37 @@
+/**
+ * HTTP client for communicating with the opencli daemon.
+ *
+ * Provides a typed send() function that posts a Command and returns a Result.
+ */
+export interface DaemonCommand {
+    id: string;
+    action: 'exec' | 'navigate' | 'tabs' | 'cookies' | 'screenshot' | 'close-window';
+    tabId?: number;
+    code?: string;
+    url?: string;
+    op?: string;
+    index?: number;
+    domain?: string;
+    format?: 'png' | 'jpeg';
+    quality?: number;
+    fullPage?: boolean;
+}
+export interface DaemonResult {
+    id: string;
+    ok: boolean;
+    data?: unknown;
+    error?: string;
+}
+/**
+ * Check if daemon is running.
+ */
+export declare function isDaemonRunning(): Promise<boolean>;
+/**
+ * Check if daemon is running AND the extension is connected.
+ */
+export declare function isExtensionConnected(): Promise<boolean>;
+/**
+ * Send a command to the daemon and wait for a result.
+ * Retries up to 3 times with 500ms delay for transient failures.
+ */
+export declare function sendCommand(action: DaemonCommand['action'], params?: Omit<DaemonCommand, 'id' | 'action'>): Promise<unknown>;

package/dist/browser/daemon-client.js

@@ -0,0 +1,82 @@
+/**
+ * HTTP client for communicating with the opencli daemon.
+ *
+ * Provides a typed send() function that posts a Command and returns a Result.
+ */
+const DAEMON_PORT = parseInt(process.env.OPENCLI_DAEMON_PORT ?? '19825', 10);
+const DAEMON_URL = `http://127.0.0.1:${DAEMON_PORT}`;
+let _idCounter = 0;
+function generateId() {
+    return `cmd_${Date.now()}_${++_idCounter}`;
+}
+/**
+ * Check if daemon is running.
+ */
+export async function isDaemonRunning() {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 2000);
+        const res = await fetch(`${DAEMON_URL}/status`, { signal: controller.signal });
+        clearTimeout(timer);
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if daemon is running AND the extension is connected.
+ */
+export async function isExtensionConnected() {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 2000);
+        const res = await fetch(`${DAEMON_URL}/status`, { signal: controller.signal });
+        clearTimeout(timer);
+        if (!res.ok)
+            return false;
+        const data = await res.json();
+        return !!data.extensionConnected;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Send a command to the daemon and wait for a result.
+ * Retries up to 3 times with 500ms delay for transient failures.
+ */
+export async function sendCommand(action, params = {}) {
+    const id = generateId();
+    const command = { id, action, ...params };
+    const maxRetries = 3;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), 30000);
+            const res = await fetch(`${DAEMON_URL}/command`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(command),
+                signal: controller.signal,
+            });
+            clearTimeout(timer);
+            const result = (await res.json());
+            if (!result.ok) {
+                throw new Error(result.error ?? 'Daemon command failed');
+            }
+            return result.data;
+        }
+        catch (err) {
+            const isRetryable = err instanceof TypeError // fetch network error
+                || (err instanceof Error && err.name === 'AbortError');
+            if (isRetryable && attempt < maxRetries) {
+                await new Promise(r => setTimeout(r, 500));
+                continue;
+            }
+            throw err;
+        }
+    }
+    // Unreachable — the loop always returns or throws
+    throw new Error('sendCommand: max retries exhausted');
+}

package/dist/browser/discover.d.ts

@@ -1,38 +1,15 @@
 /**
- * MCP server path discovery and argument building.
+ * Daemon discovery — simplified from MCP server path discovery.
+ *
+ * Only needs to check if the daemon is running. No more file system
+ * scanning for @playwright/mcp locations.
  */
-import { execSync } from 'node:child_process';
-import * as fs from 'node:fs';
-export declare function resetMcpServerPathCache(): void;
-export declare function setMcpDiscoveryTestHooks(input?: {
-    existsSync?: typeof fs.existsSync;
-    execSync?: typeof execSync;
-}): void;
-export declare function findMcpServerPath(): string | null;
+import { isDaemonRunning } from './daemon-client.js';
+export { isDaemonRunning };
 /**
- * Chrome 144+ auto-discovery: read DevToolsActivePort file to get CDP endpoint.
- *
- * Starting with Chrome 144, users can enable remote debugging from
- * chrome://inspect#remote-debugging without any command-line flags.
- * Chrome writes the active port and browser GUID to a DevToolsActivePort file
- * in the user data directory, which we read to construct the WebSocket endpoint.
+ * Check daemon status and return connection info.
  */
-export declare function discoverChromeEndpoint(): string | null;
-export declare function resolveCdpEndpoint(): {
-    endpoint?: string;
-    requestedCdp: boolean;
-};
-export declare function buildMcpArgs(input: {
-    mcpPath: string;
-    executablePath?: string | null;
-    cdpEndpoint?: string;
-}): string[];
-export declare function buildMcpLaunchSpec(input: {
-    mcpPath?: string | null;
-    executablePath?: string | null;
-    cdpEndpoint?: string;
-}): {
-    command: string;
-    args: string[];
-    usedNpxFallback: boolean;
-};
+export declare function checkDaemonStatus(): Promise<{
+    running: boolean;
+    extensionConnected: boolean;
+}>;