@jackwener/opencli 1.6.2 → 1.6.4

package/docs/adapters/index.md

@@ -1,96 +0,0 @@
-# All Adapters
-
-Run `opencli list` for the live registry.
-
-## Browser Adapters
-
-| Site | Commands | Mode |
-|------|----------|------|
-| **[twitter](./browser/twitter)** | `trending` `bookmarks` `profile` `search` `timeline` `thread` `following` `followers` `notifications` `post` `reply` `delete` `like` `likes` `article` `follow` `unfollow` `bookmark` `unbookmark` `download` `accept` `reply-dm` `block` `unblock` `hide-reply` | 🔐 Browser |
-| **[reddit](./browser/reddit)** | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` | 🔐 Browser |
-| **[tieba](./browser/tieba)** | `hot` `posts` `search` `read` | 🔐 Browser |
-| **[hupu](./browser/hupu)** | `hot` `search` `detail` `reply` `like` `unlike` | 🌐 / 🔐 |
-| **[bilibili](./browser/bilibili)** | `hot` `search` `me` `favorite` `history` `feed` `subtitle` `dynamic` `ranking` `following` `user-videos` `download` | 🔐 Browser |
-| **[zhihu](./browser/zhihu)** | `hot` `search` `question` `download` | 🔐 Browser |
-| **[xiaohongshu](./browser/xiaohongshu)** | `search` `notifications` `feed` `user` `note` `comments` `download` `publish` `creator-notes` `creator-note-detail` `creator-notes-summary` `creator-profile` `creator-stats` | 🔐 Browser |
-| **[xiaoe](./browser/xiaoe)** | `courses` `detail` `catalog` `play-url` `content` | 🔐 Browser |
-| **[xueqiu](./browser/xueqiu)** | `feed` `hot-stock` `hot` `search` `stock` `comments` `watchlist` `earnings-date` `fund-holdings` `fund-snapshot` | 🔐 Browser |
-| **[youtube](./browser/youtube)** | `search` `video` `transcript` | 🔐 Browser |
-| **[v2ex](./browser/v2ex)** | `hot` `latest` `topic` `node` `user` `member` `replies` `nodes` `daily` `me` `notifications` | 🌐 / 🔐 |
-| **[bloomberg](./browser/bloomberg)** | `main` `markets` `economics` `industries` `tech` `politics` `businessweek` `opinions` `feeds` `news` | 🌐 / 🔐 |
-| **[weibo](./browser/weibo)** | `hot` `search` `feed` `user` `me` `post` `comments` | 🔐 Browser |
-| **[linkedin](./browser/linkedin)** | `search` `timeline` | 🔐 Browser |
-| **[coupang](./browser/coupang)** | `search` `add-to-cart` | 🔐 Browser |
-| **[boss](./browser/boss)** | `search` `detail` `recommend` `joblist` `greet` `batchgreet` `send` `chatlist` `chatmsg` `invite` `mark` `exchange` `resume` `stats` | 🔐 Browser |
-| **[ctrip](./browser/ctrip)** | `search` | 🔐 Browser |
-| **[reuters](./browser/reuters)** | `search` | 🔐 Browser |
-| **[smzdm](./browser/smzdm)** | `search` | 🔐 Browser |
-| **[jike](./browser/jike)** | `feed` `search` `post` `topic` `user` `create` `comment` `like` `repost` `notifications` | 🔐 Browser |
-| **[jimeng](./browser/jimeng)** | `generate` `history` | 🔐 Browser |
-| **[yollomi](./browser/yollomi)** | `generate` `video` `edit` `upload` `models` `remove-bg` `upscale` `face-swap` `restore` `try-on` `background` `object-remover` | 🔐 Browser |
-| **[linux-do](./browser/linux-do)** | `hot` `latest` `feed` `search` `categories` `category` `tags` `topic` `user-posts` `user-topics` | 🔐 Browser |
-| **[chaoxing](./browser/chaoxing)** | `assignments` `exams` | 🔐 Browser |
-| **[grok](./browser/grok)** | `ask` | 🔐 Browser |
-| **[gemini](./browser/gemini)** | `new` `ask` `image` | 🔐 Browser |
-| **[yuanbao](./browser/yuanbao)** | `new` `ask` | 🔐 Browser |
-| **[notebooklm](./browser/notebooklm)** | `status` `list` `open` `select` `current` `get` `metadata` `source-list` `source-get` `source-fulltext` `source-guide` `history` `note-list` `notes-list` `notes-get` `summary` | 🔐 Browser |
-| **[doubao](./browser/doubao)** | `status` `new` `send` `read` `ask` `history` `detail` `meeting-summary` `meeting-transcript` | 🔐 Browser |
-| **[weread](./browser/weread)** | `shelf` `search` `book` `ranking` `notebooks` `highlights` `notes` | 🔐 Browser |
-| **[douban](./browser/douban)** | `search` `top250` `subject` `photos` `download` `marks` `reviews` `movie-hot` `book-hot` | 🔐 Browser |
-| **[facebook](./browser/facebook)** | `feed` `profile` `search` `friends` `groups` `events` `notifications` `memories` `add-friend` `join-group` | 🔐 Browser |
-| **[imdb](./browser/imdb)** | `search` `title` `top` `trending` `person` `reviews` | 🌐 / 🔐 |
-| **[instagram](./browser/instagram)** | `explore` `profile` `search` `user` `followers` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `saved` | 🔐 Browser |
-| **[medium](./browser/medium)** | `feed` `search` `user` | 🔐 Browser |
-| **[sinablog](./browser/sinablog)** | `hot` `search` `article` `user` | 🔐 Browser |
-| **[substack](./browser/substack)** | `feed` `search` `publication` | 🔐 Browser |
-| **[pixiv](./browser/pixiv)** | `ranking` `search` `user` `illusts` `detail` `download` | 🔐 Browser |
-| **[tiktok](./browser/tiktok)** | `explore` `search` `profile` `user` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `live` `notifications` `friends` | 🔐 Browser |
-| **[google](./browser/google)** | `news` `search` `suggest` `trends` | 🌐 / 🔐 |
-| **[jd](./browser/jd)** | `item` | 🔐 Browser |
-| **[amazon](./browser/amazon)** | `bestsellers` `search` `product` `offer` `discussion` | 🔐 Browser |
-| **[1688](./browser/1688)** | `search` `item` `store` | 🔐 Browser |
-| **[web](./browser/web)** | `read` | 🔐 Browser |
-| **[weixin](./browser/weixin)** | `download` | 🔐 Browser |
-| **[36kr](./browser/36kr)** | `news` `hot` `search` `article` | 🌐 / 🔐 |
-| **[producthunt](./browser/producthunt)** | `posts` `today` `hot` `browse` | 🌐 / 🔐 |
-| **[ones](./browser/ones)** | `login` `me` `token-info` `tasks` `my-tasks` `task` `worklog` `logout` | 🔐 Browser Bridge + `ONES_BASE_URL` |
-| **[band](./browser/band)** | `bands` `posts` `post` `mentions` | 🔐 Browser |
-| **[zsxq](./browser/zsxq)** | `groups` `dynamics` `topics` `topic` `search` | 🔐 Browser |
-| **[bluesky](./browser/bluesky)** | `search` `profile` `user` `feeds` `followers` `following` `thread` `trending` `starter-packs` | 🌐 Public |
-| **[douyin](./browser/douyin)** | `profile` `videos` `user-videos` `activities` `collections` `hashtag` `location` `stats` `publish` `draft` `drafts` `delete` `update` | 🔐 Browser |
-| **[xianyu](./browser/xianyu)** | `search` `item` `chat` | 🔐 Browser |
-
-## Public API Adapters
-
-| Site | Commands | Mode |
-|------|----------|------|
-| **[hackernews](./browser/hackernews)** | `top` `new` `best` `ask` `show` `jobs` `search` `user` | 🌐 Public |
-| **[bbc](./browser/bbc)** | `news` | 🌐 Public |
-| **[devto](./browser/devto)** | `top` `tag` `user` | 🌐 Public |
-| **[dictionary](./browser/dictionary)** | `search` `synonyms` `examples` | 🌐 Public |
-| **[apple-podcasts](./browser/apple-podcasts)** | `search` `episodes` `top` | 🌐 Public |
-| **[xiaoyuzhou](./browser/xiaoyuzhou)** | `podcast` `podcast-episodes` `episode` | 🌐 Public |
-| **[yahoo-finance](./browser/yahoo-finance)** | `quote` | 🌐 Public |
-| **[arxiv](./browser/arxiv)** | `search` `paper` | 🌐 Public |
-| **[paperreview](./browser/paperreview)** | `submit` `review` `feedback` | 🌐 Public |
-| **[barchart](./browser/barchart)** | `quote` `options` `greeks` `flow` | 🌐 Public |
-| **[hf](./browser/hf)** | `top` | 🌐 Public |
-| **[sinafinance](./browser/sinafinance)** | `news` | 🌐 Public |
-| **[spotify](./browser/spotify)** | `auth` `status` `play` `pause` `next` `prev` `volume` `search` `queue` `shuffle` `repeat` | 🔑 OAuth API |
-| **[stackoverflow](./browser/stackoverflow)** | `hot` `search` `bounties` `unanswered` | 🌐 Public |
-| **[wikipedia](./browser/wikipedia)** | `search` `summary` `random` `trending` | 🌐 Public |
-| **[lobsters](./browser/lobsters)** | `hot` `newest` `active` `tag` | 🌐 Public |
-| **[steam](./browser/steam)** | `top-sellers` | 🌐 Public |
-
-## Desktop Adapters
-
-| App | Description | Commands |
-|-----|-------------|----------|
-| **[Cursor](./desktop/cursor)** | Control Cursor IDE | `status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export` |
-| **[Codex](./desktop/codex)** | Drive OpenAI Codex CLI agent | `status` `send` `read` `new` `extract-diff` `model` `ask` `screenshot` `history` `export` |
-| **[Antigravity](./desktop/antigravity)** | Control Antigravity Ultra | `status` `send` `read` `new` `dump` `extract-code` `model` `watch` |
-| **[ChatGPT](./desktop/chatgpt)** | Automate ChatGPT macOS app | `status` `new` `send` `read` `ask` `model` |
-| **[ChatWise](./desktop/chatwise)** | Multi-LLM client | `status` `new` `send` `read` `ask` `model` `history` `export` `screenshot` |
-| **[Notion](./desktop/notion)** | Search, read, write pages | `status` `search` `read` `new` `write` `sidebar` `favorites` `export` |
-| **[Discord](./desktop/discord)** | Desktop messages & channels | `status` `send` `read` `channels` `servers` `search` `members` |
-| **[Doubao App](./desktop/doubao-app)** | Doubao AI desktop app via CDP | `status` `new` `send` `read` `ask` `screenshot` `dump` |

package/docs/adapters-doc/ones.md

@@ -1,32 +0,0 @@
-# ONES 项目管理平台（OpenCLI）
-
-基于官方 [ONES Project API](https://developer.ones.cn/zh-CN/docs/api/readme/)，经 **Chrome + Browser Bridge** 在页面里 `fetch`（`credentials: 'include'`）。
-
-## 环境变量
-
-| 变量 | 必填 | 说明 |
-|------|------|------|
-| `ONES_BASE_URL` | 是 | 与 Chrome 中访问的 ONES 根 URL 一致 |
-| `ONES_USER_ID` / `ONES_AUTH_TOKEN` | 视部署 | 若接口强制要文档中的 Header，再设置（可先只依赖浏览器登录） |
-| `ONES_EMAIL` / `ONES_PHONE` / `ONES_PASSWORD` | 否 | 供 `ones login` 脚本化 |
-
-## 命令
-
-```bash
-export ONES_BASE_URL=https://your-host
-# 安装扩展，Chrome 已登录 ONES
-
-opencli ones me
-opencli ones token-info              # teams column includes name(uuid), useful for tasks
-opencli ones tasks <teamUUID> --limit 20 --project <optional>
-opencli ones my-tasks <teamUUID> --limit 100              # default assignee=self
-opencli ones my-tasks <teamUUID> --mode field004         # deployments using field004 as assignee
-opencli ones my-tasks <teamUUID> --mode both             # assignee OR creator
-opencli ones task <taskUUID> --team <teamUUID>           # single task (URL .../task/<uuid>)
-opencli ones worklog <taskUUID> 2 --team <teamUUID>      # log hours for today
-opencli ones worklog <taskUUID> 1 --team <teamUUID> --date 2026-03-01  # backfill
-opencli ones login --email you@corp.com --password '***'   # optional; stderr prints header export hints
-opencli ones logout
-```
-
-更完整的说明见 [docs/adapters/browser/ones.md](../adapters/browser/ones.md)。

package/docs/advanced/cdp.md

@@ -1,103 +0,0 @@
-# Connecting OpenCLI via CDP (Remote/Headless Servers)
-
-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.
-
-This guide is broken down into three phases:
-1. **Preparation**: Start Chrome with CDP enabled locally.
-2. **Network Tunnels**: Expose that CDP port to your remote server using either **SSH Tunnels** or **Reverse Proxies**.
-3. **Execution**: Run OpenCLI on your server.
-
----
-
-## Phase 1: Preparation (Local Machine)
-
-First, you need to start a Chrome browser on your local machine with remote debugging enabled.
-
-**macOS:**
-```bash
-/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
-  --remote-debugging-port=9222 \
-  --user-data-dir="$HOME/chrome-debug-profile" \
-  --remote-allow-origins="*"
-```
-
-**Linux:**
-```bash
-google-chrome \
-  --remote-debugging-port=9222 \
-  --user-data-dir="$HOME/chrome-debug-profile" \
-  --remote-allow-origins="*"
-```
-
-**Windows:**
-```cmd
-"C:\Program Files\Google\Chrome\Application\chrome.exe" ^
-  --remote-debugging-port=9222 ^
-  --user-data-dir="%USERPROFILE%\chrome-debug-profile" ^
-  --remote-allow-origins="*"
-```
-
-> **Note**: The `--remote-allow-origins="*"` flag is often required for modern Chrome versions to accept cross-origin CDP WebSocket connections (e.g. from reverse proxies like ngrok).
-
-Once this browser instance opens, **log into the target websites you want to use** (e.g., bilibili.com, zhihu.com) so that the session contains the correct cookies.
-
----
-
-## Phase 2: Remote Access Methods
-
-Once CDP is running locally on port `9222`, you must securely expose this port to your remote server. Choose one of the two methods below depending on your network conditions.
-
-### Method A: SSH Tunnel (Recommended)
-
-If your local machine has SSH access to the remote server, this is the most secure and straightforward method.
-
-Run this command on your **Local Machine** to forward the remote server's port `9222` back to your local port `9222`:
-
-```bash
-ssh -R 9222:localhost:9222 your-server-user@your-server-ip
-```
-
-Leave this SSH session running in the background.
-
-### Method B: Reverse Proxy (ngrok / frp / socat)
-
-If you cannot establish a direct SSH connection (e.g., due to NAT or firewalls), you can use an intranet penetration tool like `ngrok`.
-
-Run this command on your **Local Machine** to expose your local port `9222` to the public internet securely via ngrok:
-
-```bash
-ngrok http 9222
-```
-
-This will print a forwarding URL, such as `https://abcdef.ngrok.app`. **Copy this URL**.
-
----
-
-## Phase 3: Execution (Remote Server)
-
-Now switch to your **Remote Server** where OpenCLI is installed. 
-
-Depending on the network tunnel method you chose in Phase 2, set the `OPENCLI_CDP_ENDPOINT` environment variable and run your commands.
-
-### If you used Method A (SSH Tunnel):
-
-```bash
-export OPENCLI_CDP_ENDPOINT="http://localhost:9222"
-opencli doctor                    # Verify connection
-opencli bilibili hot --limit 5    # Test a command
-```
-
-### If you used Method B (Reverse Proxy like ngrok):
-
-```bash
-# Use the URL you copied from ngrok earlier
-export OPENCLI_CDP_ENDPOINT="https://abcdef.ngrok.app"
-opencli doctor                    # Verify connection
-opencli bilibili hot --limit 5    # Test a command
-```
-
-> *Tip: If you provide a standard HTTP/HTTPS CDP endpoint, OpenCLI requests the `/json` target list and picks the most likely inspectable app/page target automatically. If multiple app targets exist, you can further narrow selection with `OPENCLI_CDP_TARGET` (for example `antigravity` or `codex`).*
-
-If you plan to use this setup frequently, you can persist the environment variable by adding the `export` line to your `~/.bashrc` or `~/.zshrc` on the server.

package/docs/advanced/download.md

@@ -1,71 +0,0 @@
-# Download Support
-
-OpenCLI supports downloading images, videos, and articles from supported platforms.
-
-## Supported Platforms
-
-| Platform | Content Types | Notes |
-|----------|---------------|-------|
-| **xiaohongshu** | Images, Videos | Downloads all media from a note |
-| **bilibili** | Videos | Requires `yt-dlp` installed |
-| **twitter** | Images, Videos | Downloads from user media tab or single tweet |
-| **douban** | Images | Downloads poster / still image lists from movie subjects |
-| **zhihu** | Articles (Markdown) | Exports articles with optional image download |
-| **weixin** | Articles (Markdown) | Exports WeChat Official Account articles |
-
-## Prerequisites
-
-For video downloads from streaming platforms, install `yt-dlp`:
-
-```bash
-# Install yt-dlp
-pip install yt-dlp
-# or
-brew install yt-dlp
-```
-
-## Usage Examples
-
-```bash
-# Download images/videos from Xiaohongshu note
-opencli xiaohongshu download --note-id abc123 --output ./xhs
-
-# Download Bilibili video (requires yt-dlp)
-opencli bilibili download --bvid BV1xxx --output ./bilibili
-opencli bilibili download --bvid BV1xxx --quality 1080p
-
-# Download Twitter media from user
-opencli twitter download elonmusk --limit 20 --output ./twitter
-
-# Download single tweet media
-opencli twitter download --tweet-url "https://x.com/user/status/123" --output ./twitter
-
-# Download Douban posters / stills
-opencli douban download 30382501 --output ./douban
-
-# Export Zhihu article to Markdown
-opencli zhihu download "https://zhuanlan.zhihu.com/p/xxx" --output ./zhihu
-
-# Export with local images
-opencli zhihu download "https://zhuanlan.zhihu.com/p/xxx" --download-images
-
-# Export WeChat article to Markdown
-opencli weixin download --url "https://mp.weixin.qq.com/s/xxx" --output ./weixin
-```
-
-## Pipeline Step (YAML Adapters)
-
-The `download` step can be used in YAML pipelines:
-
-::: v-pre
-```yaml
-pipeline:
-  - fetch: https://api.example.com/media
-  - download:
-      url: ${{ item.imageUrl }}
-      dir: ./downloads
-      filename: ${{ item.title | sanitize }}.jpg
-      concurrency: 5
-      skip_existing: true
-```
-:::

package/docs/advanced/electron.md

@@ -1,125 +0,0 @@
----
-description: How to CLI-ify and automate any Electron Desktop Application via CDP
----
-
-# CLI-ifying Electron Applications (Skill Guide)
-
-Based on the successful automation of **Cursor**, **Codex**, **Antigravity**, **ChatWise**, **Notion**, and **Discord** desktop apps, this guide serves as the standard operating procedure (SOP) for adapting ANY Electron-based application into an OpenCLI adapter.
-
-## 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 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)).
-
-### Launching the Target App
-```bash
-/Applications/AppName.app/Contents/MacOS/AppName --remote-debugging-port=9222
-```
-
-### Verifying Electron
-```bash
-# Check for Electron Framework in the app bundle
-ls /Applications/AppName.app/Contents/Frameworks/Electron\ Framework.framework
-# If this directory exists → Electron → CDP works
-# If not → check for libEGL.dylib (embedded Chromium/CEF, CDP may not work)
-```
-
-## The 5-Command Pattern (CDP / Electron)
-
-Every new Electron adapter should implement these 5 commands in `src/clis/<app_name>/`:
-
-### 1. `status.ts` — Connection Test
-```typescript
-export const statusCommand = cli({
-  site: 'myapp',
-  name: 'status',
-  domain: 'localhost',
-  strategy: Strategy.UI,
-  browser: true,       // Requires CDP connection
-  args: [],
-  columns: ['Status', 'Url', 'Title'],
-  func: async (page: IPage) => {
-    const url = await page.evaluate('window.location.href');
-    const title = await page.evaluate('document.title');
-    return [{ Status: 'Connected', Url: url, Title: title }];
-  },
-});
-```
-
-### 2. `dump.ts` — Reverse Engineering Core
-Modern app DOMs are huge and obfuscated. **Never guess selectors.** Dump first, then extract precise class names with AI or `grep`:
-```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` — Advanced Text Injection
-Electron apps often use complex rich-text editors (Monaco, Lexical, ProseMirror). Setting `.value` directly is ignored by React state.
-
-**Best practice:** Use `document.execCommand('insertText')` to perfectly simulate real user input, fully piercing React state:
-```javascript
-const composer = document.querySelector('[contenteditable="true"]');
-composer.focus();
-document.execCommand('insertText', false, 'Hello');
-```
-Then submit with `await page.pressKey('Enter')`.
-
-### 4. `read.ts` — Context Extraction
-Don't extract the entire page text. Use `dump.ts` output to find the real "conversation container":
-- Look for semantic selectors: `[role="log"]`, `[data-testid="conversation"]`, `[data-content-search-turn-key]`
-- Format output as Markdown — readable by both humans and LLMs
-
-### 5. `new.ts` — Keyboard Shortcuts
-Many GUI actions respond to native shortcuts rather than button clicks:
-```typescript
-const isMac = process.platform === 'darwin';
-await page.pressKey(isMac ? 'Meta+N' : 'Control+N');
-await page.wait(1); // Wait for re-render
-```
-
-## Environment Variable
-```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9222"
-```
-
-## Non-Electron Pattern (AppleScript)
-
-For native macOS apps (WeChat, Feishu) that don't expose CDP:
-```typescript
-export const statusCommand = cli({
-  site: 'myapp',
-  strategy: Strategy.PUBLIC,
-  browser: false,       // No browser needed
-  func: async (page: IPage | null) => {
-    const output = execSync("osascript -e 'application \"MyApp\" is running'", { encoding: 'utf-8' }).trim();
-    return [{ Status: output === 'true' ? 'Running' : 'Stopped' }];
-  },
-});
-```
-
-Core techniques:
-- **status**: `osascript -e 'application "AppName" is running'`
-- **send**: `pbcopy` → activate window → `Cmd+V` → `Enter`
-- **read**: `Cmd+A` → `Cmd+C` → `pbpaste`
-- **search**: Activate → `Cmd+F`/`Cmd+K` → `keystroke "query"`
-
-## 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 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
-
-## Port Assignment Table
-
-| App | Port | Mode |
-|-----|------|------|
-| Codex | 9222 | CDP |
-| ChatGPT | 9224 | CDP / AppleScript |
-| Cursor | 9226 | CDP |
-| ChatWise | 9228 | CDP |
-| Notion | 9230 | CDP |
-| Discord App | 9232 | CDP |

package/docs/advanced/rate-limiter-plugin.md

@@ -1,99 +0,0 @@
-# Rate Limiter Plugin
-
-An optional plugin that adds a random sleep between browser-based commands to reduce the risk of platform rate-limiting or bot detection.
-
-## Install
-
-```bash
-opencli plugin install github:jackwener/opencli-plugin-rate-limiter
-```
-
-Or copy the example below into `~/.opencli/plugins/rate-limiter/` to use it locally without installing from GitHub.
-
-## What it does
-
-After every command targeting a browser platform (xiaohongshu, weibo, bilibili, douyin, tiktok, …), the plugin sleeps for a random duration — 5–30 seconds by default — before returning control to the caller.
-
-## Configuration
-
-| Variable | Default | Description |
-|---|---|---|
-| `OPENCLI_RATE_MIN` | `5` | Minimum sleep in seconds |
-| `OPENCLI_RATE_MAX` | `30` | Maximum sleep in seconds |
-| `OPENCLI_NO_RATE` | — | Set to `1` to disable entirely (local dev) |
-
-```bash
-# Shorter delays for light scraping
-OPENCLI_RATE_MIN=3 OPENCLI_RATE_MAX=10 opencli xiaohongshu search "AI眼镜"
-
-# Skip delays when iterating locally
-OPENCLI_NO_RATE=1 opencli bilibili comments BV1WtAGzYEBm
-```
-
-## Local installation (without GitHub)
-
-1. Create the plugin directory:
-
-   ```bash
-   mkdir -p ~/.opencli/plugins/rate-limiter
-   ```
-
-2. Create `~/.opencli/plugins/rate-limiter/package.json`:
-
-   ```json
-   { "type": "module" }
-   ```
-
-3. Create `~/.opencli/plugins/rate-limiter/index.js`:
-
-   ```js
-   import { onAfterExecute } from '@jackwener/opencli/hooks'
-
-   const BROWSER_DOMAINS = [
-     'xiaohongshu', 'weibo', 'bilibili', 'douyin', 'tiktok',
-     'instagram', 'twitter', 'youtube', 'zhihu', 'douban',
-     'jike', 'weixin', 'xiaoyuzhou',
-   ]
-
-   onAfterExecute(async (ctx) => {
-     if (process.env.OPENCLI_NO_RATE === '1') return
-
-     const site = ctx.command?.split('/')?.[0] ?? ''
-     if (!BROWSER_DOMAINS.includes(site)) return
-
-     const min = Number(process.env.OPENCLI_RATE_MIN ?? 5)
-     const max = Number(process.env.OPENCLI_RATE_MAX ?? 30)
-     const ms = Math.floor(Math.random() * (max - min + 1) + min) * 1000
-
-     process.stderr.write(`[rate-limiter] ${site}: sleeping ${(ms / 1000).toFixed(0)}s\n`)
-     await new Promise(r => setTimeout(r, ms))
-   })
-   ```
-
-4. Verify it loaded:
-
-   ```bash
-   OPENCLI_NO_RATE=1 opencli xiaohongshu search "test" 2>&1 | grep rate-limiter
-   # → (no output — plugin loaded but rate limit skipped)
-
-   opencli xiaohongshu search "test" 2>&1 | grep rate-limiter
-   # → [rate-limiter] xiaohongshu: sleeping 12s
-   ```
-
-## Writing your own plugin
-
-Plugins are plain JS/TS files in `~/.opencli/plugins/<name>/`. A plugin file must export a hook registration call that matches the pattern `onStartup(`, `onBeforeExecute(`, or `onAfterExecute(` — opencli's discovery engine uses this pattern to identify hook files vs. command files.
-
-```js
-// ~/.opencli/plugins/my-plugin/index.js
-import { onAfterExecute } from '@jackwener/opencli/hooks'
-
-onAfterExecute(async (ctx) => {
-  // ctx.command — e.g. "bilibili/comments"
-  // ctx.args    — coerced command arguments
-  // ctx.error   — set if the command threw
-  console.error(`[my-plugin] finished: ${ctx.command}`)
-})
-```
-
-See [hooks.ts](../../src/hooks.ts) for the full `HookContext` type.

package/docs/advanced/remote-chrome.md

@@ -1,72 +0,0 @@
-# Remote Chrome
-
-Run OpenCLI on a server or headless environment by connecting to a remote Chrome instance.
-
-## Use Cases
-
-- Running CLI commands on a remote server
-- CI/CD automation with headed browser
-- Shared team browser sessions
-
-## Setup
-
-### 1. Start Chrome on the Remote Machine
-
-```bash
-# On the remote machine (or your Mac)
-/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
-  --remote-debugging-port=9222
-```
-
-### 2. SSH Tunnel (If Needed)
-
-If the remote Chrome is on a different machine, create an SSH tunnel:
-
-```bash
-# On your local machine or server
-ssh -L 9222:127.0.0.1:9222 user@remote-host
-```
-
-::: warning
-Use `127.0.0.1` instead of `localhost` in the SSH command to avoid IPv6 resolution issues that can cause timeouts.
-:::
-
-### 3. Configure OpenCLI
-
-```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9222"
-```
-
-### 4. Verify
-
-```bash
-# Test the connection
-curl http://127.0.0.1:9222/json/version
-
-# Run a diagnostic
-opencli doctor
-```
-
-## CI/CD Integration
-
-For CI/CD environments, use a real Chrome instance with `xvfb`:
-
-::: v-pre
-```yaml
-steps:
-  - uses: browser-actions/setup-chrome@latest
-    id: setup-chrome
-  - run: |
-      xvfb-run --auto-servernum \
-        ${{ steps.setup-chrome.outputs.chrome-path }} \
-        --remote-debugging-port=9222 &
-```
-:::
-
-Set the browser executable path:
-::: v-pre
-```yaml
-env:
-  OPENCLI_BROWSER_EXECUTABLE_PATH: ${{ steps.setup-chrome.outputs.chrome-path }}
-```
-:::