@jackwener/opencli 1.6.1 → 1.6.3

package/docs/adapters/desktop/chatgpt.md

@@ -1,49 +0,0 @@
-# ChatGPT
-
-Control the **ChatGPT macOS Desktop App** directly from the terminal. OpenCLI supports two automation approaches for ChatGPT.
-
-## Approach 1: AppleScript (Default, No Setup)
-
-The current built-in commands use native AppleScript automation — no extra launch flags needed.
-
-### Prerequisites
-1. Install the official [ChatGPT Desktop App](https://openai.com/chatgpt/mac/) from OpenAI.
-2. Grant **Accessibility permissions** to your terminal app in **System Settings → Privacy & Security → Accessibility**.
-
-### Commands
-- `opencli chatgpt status`: Check if the ChatGPT app is currently running.
-- `opencli chatgpt new`: Activate ChatGPT and press `Cmd+N` to start a new conversation.
-- `opencli chatgpt send "message"`: Copy your message to clipboard, activate ChatGPT, paste, and submit.
-- `opencli chatgpt send "message" --model thinking`: Switch model/mode first, then send the message.
-- `opencli chatgpt read`: Read the last visible message from the focused ChatGPT window via the Accessibility tree.
-- `opencli chatgpt ask "message"`: Send a prompt and wait for the visible reply in one shot.
-- `opencli chatgpt ask "message" --model instant`: Run a one-shot prompt using a specific model/mode.
-- `opencli chatgpt model thinking`: Switch the active ChatGPT model/mode without sending a message.
-
-Supported model choices: `auto`, `instant`, `thinking`, `5.2-instant`, `5.2-thinking`.
-
-## Approach 2: CDP (Advanced, Electron Debug Mode)
-
-ChatGPT Desktop is also an Electron app and can be launched with a remote debugging port:
-
-```bash
-/Applications/ChatGPT.app/Contents/MacOS/ChatGPT \
-  --remote-debugging-port=9224
-```
-
-```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9224"
-```
-
-> The CDP approach is primarily for advanced automation and future desktop-only commands. The built-in command set above still works in the default AppleScript path unless you explicitly route through `OPENCLI_CDP_ENDPOINT`.
-
-## How It Works
-
-- **AppleScript mode**: Uses `osascript` to control ChatGPT, `pbcopy`/`pbpaste` to paste prompts, and the macOS Accessibility tree to read visible chat messages.
-- **CDP mode**: Connects via Chrome DevTools Protocol to the Electron renderer process.
-
-## Limitations
-
-- macOS only (AppleScript dependency)
-- AppleScript mode requires Accessibility permissions
-- `read` returns the last visible message in the focused ChatGPT window — scroll first if the message you want is not visible

package/docs/adapters/desktop/chatwise.md

@@ -1,38 +0,0 @@
-# ChatWise
-
-Control the **ChatWise Desktop App** from the terminal via Chrome DevTools Protocol (CDP). ChatWise is an Electron-based multi-LLM client supporting GPT-4, Claude, Gemini, and more.
-
-## Prerequisites
-
-1. Install [ChatWise](https://chatwise.app/).
-2. Launch with remote debugging port:
-   ```bash
-   /Applications/ChatWise.app/Contents/MacOS/ChatWise \
-     --remote-debugging-port=9228
-   ```
-
-## Setup
-
-```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9228"
-```
-
-## Commands
-
-### Diagnostics
-- `opencli chatwise status`: Check CDP connection status.
-- `opencli chatwise screenshot`: Export DOM + accessibility snapshot.
-
-### Chat
-- `opencli chatwise new`: Start a new conversation (`Cmd+N`).
-- `opencli chatwise send "message"`: Send a message to the active chat.
-- `opencli chatwise read`: Read the current conversation.
-- `opencli chatwise ask "prompt"`: Send + wait for response + return it (one-shot).
-
-### AI Features
-- `opencli chatwise model`: Get the current AI model.
-- `opencli chatwise model gpt-4`: Switch to a different model.
-
-### Organization
-- `opencli chatwise history`: List conversations from the sidebar.
-- `opencli chatwise export`: Export conversation as Markdown.

package/docs/adapters/desktop/codex.md

@@ -1,36 +0,0 @@
-# Codex
-
-Control the **OpenAI Codex Desktop App** headless or headfully via Chrome DevTools Protocol (CDP). Because Codex is built on Electron, OpenCLI can directly drive its internal UI, automate slash commands, and manipulate its AI agent threads.
-
-## Prerequisites
-
-1. You must have the official OpenAI Codex app installed.
-2. Launch it via the terminal and expose the remote debugging port:
-   ```bash
-   # macOS
-   /Applications/Codex.app/Contents/MacOS/Codex --remote-debugging-port=9222
-   ```
-
-## Setup
-
-```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9222"
-```
-
-## Commands
-
-### Diagnostics
-- `opencli codex status`: Checks connection and reads the current active window URL/title.
-- `opencli codex dump`: Dumps the full UI DOM and Accessibility tree into `/tmp`.
-- `opencli codex screenshot`: Captures DOM + snapshot artifacts of the current window.
-
-### Agent Manipulation
-- `opencli codex new`: Simulates `Cmd+N` to start a completely fresh and isolated Git Worktree thread context.
-- `opencli codex send "message"`: Robustly finds the active Thread Composer and injects your text.
-  - *Pro-tip*: You can trigger internal shortcuts, e.g., `opencli codex send "/review"`.
-- `opencli codex ask "message"`: Send + wait + read in one shot.
-- `opencli codex read`: Extracts the entire current thread history and AI reasoning logs.
-- `opencli codex extract-diff`: Automatically scrapes any visual Patch chunks and Code Diffs.
-- `opencli codex model`: Get the currently active AI model.
-- `opencli codex history`: List recent conversation threads from the sidebar.
-- `opencli codex export`: Export the current conversation as Markdown.

package/docs/adapters/desktop/cursor.md

@@ -1,37 +0,0 @@
-# Cursor
-
-Control the **Cursor IDE** from the terminal via Chrome DevTools Protocol (CDP). Since Cursor is built on Electron (VS Code fork), OpenCLI can drive its internal UI, automate Composer interactions, and manipulate chat sessions.
-
-## Prerequisites
-
-1. Install [Cursor](https://cursor.sh/).
-2. Launch it with the remote debugging port:
-   ```bash
-   /Applications/Cursor.app/Contents/MacOS/Cursor --remote-debugging-port=9226
-   ```
-
-## Setup
-
-```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9226"
-```
-
-## Commands
-
-### Diagnostics
-- `opencli cursor status`: Check CDP connection status.
-- `opencli cursor dump`: Dump the full DOM and Accessibility snapshot to `/tmp/cursor-dom.html` and `/tmp/cursor-snapshot.json`.
-- `opencli cursor screenshot`: Capture DOM + snapshot artifacts of the current window.
-
-### Chat Manipulation
-- `opencli cursor new`: Press `Cmd+N` to start a new file/tab.
-- `opencli cursor send "message"`: Inject text into the active Composer/Chat input and submit.
-- `opencli cursor ask "message"`: Send + wait + read in one shot.
-- `opencli cursor read`: Extract the full conversation history from the active chat panel.
-
-### AI Features
-- `opencli cursor composer "prompt"`: Open the Composer panel (`Cmd+I`) and send a prompt for inline AI editing.
-- `opencli cursor model`: Get the currently active AI model (e.g., `claude-4.5-sonnet`).
-- `opencli cursor extract-code`: Extract all code blocks from the current conversation.
-- `opencli cursor history`: List recent chat/composer sessions from the sidebar.
-- `opencli cursor export`: Export the current conversation as Markdown.

package/docs/adapters/desktop/discord.md

@@ -1,28 +0,0 @@
-# Discord
-
-Control the **Discord Desktop App** from the terminal via Chrome DevTools Protocol (CDP).
-
-## Prerequisites
-
-Launch with remote debugging port:
-```bash
-/Applications/Discord.app/Contents/MacOS/Discord --remote-debugging-port=9232
-```
-
-## Setup
-
-```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9232"
-```
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli discord-app status` | Check CDP connection |
-| `opencli discord-app send "message"` | Send a message in the active channel |
-| `opencli discord-app read` | Read recent messages |
-| `opencli discord-app channels` | List channels in the current server |
-| `opencli discord-app servers` | List all joined servers |
-| `opencli discord-app search "query"` | Search messages (Cmd+F) |
-| `opencli discord-app members` | List online members |

package/docs/adapters/desktop/doubao-app.md

@@ -1,35 +0,0 @@
-# Doubao App (豆包桌面版)
-
-Control the **Doubao AI Desktop App** via Chrome DevTools Protocol (CDP).
-
-## Prerequisites
-
-1. Launch Doubao Desktop with remote debugging enabled:
-   ```bash
-   /Applications/Doubao.app/Contents/MacOS/Doubao --remote-debugging-port=9225
-   ```
-2. Set the CDP endpoint:
-   ```bash
-   export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9225"
-   ```
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli doubao-app status` | Check CDP connection status |
-| `opencli doubao-app new` | Start a new conversation |
-| `opencli doubao-app send "message"` | Send a message to the current chat |
-| `opencli doubao-app read` | Read the latest assistant reply |
-| `opencli doubao-app ask "message"` | Send a prompt and wait for the reply |
-| `opencli doubao-app screenshot` | Capture a screenshot of the app window |
-| `opencli doubao-app dump` | Export DOM and snapshot debug info |
-
-## How It Works
-
-Connects to the Doubao Electron app via CDP, injecting JavaScript into the renderer process to control the chat UI — sending messages, reading replies, and capturing screenshots.
-
-## Limitations
-
-- Requires Doubao Desktop to be launched with `--remote-debugging-port`
-- macOS / Linux / Windows (Electron-based, platform independent)

package/docs/adapters/desktop/notion.md

@@ -1,29 +0,0 @@
-# Notion
-
-Control the **Notion Desktop App** from the terminal via Chrome DevTools Protocol (CDP).
-
-## Prerequisites
-
-Launch with remote debugging port:
-```bash
-/Applications/Notion.app/Contents/MacOS/Notion --remote-debugging-port=9230
-```
-
-## Setup
-
-```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9230"
-```
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli notion status` | Check CDP connection |
-| `opencli notion search "query"` | Quick Find search (Cmd+P) |
-| `opencli notion read` | Read the current page content |
-| `opencli notion new "title"` | Create a new page (Cmd+N) |
-| `opencli notion write "text"` | Append text to the current page |
-| `opencli notion sidebar` | List pages from the sidebar |
-| `opencli notion favorites` | List pages from the Favorites section |
-| `opencli notion export` | Export page as Markdown |

package/docs/adapters/index.md

@@ -1,87 +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` `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 |
-| **[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` `download` `publish` `creator-notes` `creator-note-detail` `creator-notes-summary` `creator-profile` `creator-stats` | 🔐 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` | 🔐 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)** | `feed` `categories` `tags` `search` `topic` `user-topics` `user-posts` | 🔐 Browser |
-| **[chaoxing](./browser/chaoxing)** | `assignments` `exams` | 🔐 Browser |
-| **[grok](./browser/grok)** | `ask` | 🔐 Browser |
-| **[gemini](./browser/gemini)** | `new` `ask` `image` | 🔐 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 |
-| **[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` |
-
-## 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` |
-| **[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
-```
-:::