@jackwener/opencli 1.6.2 → 1.6.4

package/docs/adapters/browser/yahoo-finance.md

@@ -1,27 +0,0 @@
-# Yahoo Finance
-
-**Mode**: 🔐 Browser · **Domain**: `finance.yahoo.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli yahoo-finance quote` | |
-
-## Usage Examples
-
-```bash
-# Quick start
-opencli yahoo-finance quote AAPL
-
-# JSON output
-opencli yahoo-finance quote TSLA -f json
-
-# Verbose mode
-opencli yahoo-finance quote NVDA -v
-```
-
-## Prerequisites
-
-- Chrome running and able to open `finance.yahoo.com`
-- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/yollomi.md

@@ -1,69 +0,0 @@
-# Yollomi
-
-**Mode**: 🔐 Browser · **Domain**: `yollomi.com`
-
-AI image/video generation and editing on [yollomi.com](https://yollomi.com). Uses the same `/api/ai/*` routes as the web app; authentication is your **logged-in Chrome session** (NextAuth cookies).
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli yollomi generate` | Text-to-image / image-to-image |
-| `opencli yollomi video` | Text-to-video / image-to-video |
-| `opencli yollomi edit` | Qwen image edit (prompt + image) |
-| `opencli yollomi upload` | Upload a local file → public URL for other commands |
-| `opencli yollomi models` | List image / video / tool models and credit costs |
-| `opencli yollomi remove-bg` | Remove background (free) |
-| `opencli yollomi upscale` | Image upscaling |
-| `opencli yollomi face-swap` | Face swap between two images |
-| `opencli yollomi restore` | Photo restoration |
-| `opencli yollomi try-on` | Virtual try-on |
-| `opencli yollomi background` | AI background for product/object images |
-| `opencli yollomi object-remover` | Remove objects (image + mask URLs) |
-
-## Usage Examples
-
-```bash
-# List models
-opencli yollomi models --type image
-
-# Text-to-image (default model: z-image-turbo)
-opencli yollomi generate "a red apple on a wooden table"
-
-# Choose model and aspect ratio
-opencli yollomi generate "sunset" --model flux-schnell --ratio 16:9
-
-# Image-to-image: upload first, then pass URL
-opencli yollomi upload ./photo.png
-opencli yollomi generate "oil painting style" --model flux-2-pro --image "https://..."
-
-# Video
-opencli yollomi video "waves on a beach" --model kling-2-1
-
-# Tools
-opencli yollomi remove-bg https://example.com/image.png
-opencli yollomi upscale https://example.com/image.png --scale 4
-opencli yollomi edit https://example.com/in.png "make it vintage"
-```
-
-### Common options
-
-| Option | Applies to | Description |
-|--------|------------|-------------|
-| `--model` | `generate`, `video` | Model id (see `yollomi models`) |
-| `--ratio` | `generate`, `video` | Aspect ratio, e.g. `1:1`, `16:9` |
-| `--image` | `generate`, `video` | Image URL for img2img / i2v |
-| `--output` | Most | Output directory (default `./yollomi-output`) |
-| `--no-download` | Several | Print URLs only, skip saving files |
-
-## Prerequisites
-
-- Chrome running and **logged into** [yollomi.com](https://yollomi.com) (Google OAuth)
-- [Browser Bridge extension](/guide/browser-bridge) installed; daemon connects on first command
-
-The CLI ensures the automation tab is on `yollomi.com` before calling APIs (same-origin `fetch` with session cookies).
-
-## Notes
-
-- **Credits**: Each model consumes account credits; insufficient credits returns HTTP 402.
-- **Upload**: Local paths for tools are not accepted directly — use `yollomi upload` to get a URL, or pass an existing HTTPS image URL.

package/docs/adapters/browser/youtube.md

@@ -1,29 +0,0 @@
-# YouTube
-
-**Mode**: 🔐 Browser · **Domain**: `youtube.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli youtube search` | |
-| `opencli youtube video` | |
-| `opencli youtube transcript` | |
-
-## Usage Examples
-
-```bash
-# Quick start
-opencli youtube search --limit 5
-
-# JSON output
-opencli youtube search -f json
-
-# Verbose mode
-opencli youtube search -v
-```
-
-## Prerequisites
-
-- Chrome running and **logged into** youtube.com
-- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/yuanbao.md

@@ -1,64 +0,0 @@
-# Yuanbao
-
-**Mode**: 🔐 Browser · **Domain**: `yuanbao.tencent.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli yuanbao new` | Start a new Yuanbao conversation |
-| `opencli yuanbao ask <prompt>` | Send a prompt to Yuanbao web chat and wait for the reply |
-
-## Usage Examples
-
-```bash
-# Start a fresh chat
-opencli yuanbao new
-
-# Basic ask (internet search on by default, deep thinking off by default)
-opencli yuanbao ask "你好"
-
-# Wait longer for a longer answer
-opencli yuanbao ask "帮我总结这篇文章" --timeout 90
-
-# Disable internet search explicitly
-opencli yuanbao ask "你好" --search false
-
-# Enable deep thinking explicitly
-opencli yuanbao ask "你好" --think true
-```
-
-## Options
-
-### `new`
-
-- No options
-
-### `ask`
-
-| Option | Description |
-|--------|-------------|
-| `prompt` | Prompt to send (required positional argument) |
-| `--timeout` | Max seconds to wait for a reply (default: `60`) |
-| `--search` | Enable internet search before sending (default: `true`) |
-| `--think` | Enable deep thinking before sending (default: `false`) |
-
-## Behavior
-
-- The adapter targets the Yuanbao consumer web UI and sends the prompt through the visible Quill composer.
-- `new` clicks the left-side Yuanbao new-chat trigger and falls back to reloading the Yuanbao homepage if needed.
-- Before sending, it aligns the `联网搜索` and `深度思考` buttons to the requested `--search` / `--think` state.
-- It waits for transcript changes to stabilize before returning the assistant reply.
-- If Yuanbao opens a login gate instead of answering, the command returns a `[BLOCKED]` system message with a session hint.
-
-## Prerequisites
-
-- Chrome is running
-- You are already logged into `yuanbao.tencent.com`
-- [Browser Bridge extension](/guide/browser-bridge) is installed
-
-## Caveats
-
-- This adapter drives the Yuanbao web UI, not a public API.
-- It depends on the current browser session and may fail if Yuanbao shows login, consent, challenge, or other gating UI.
-- DOM or product changes on Yuanbao can break composer detection, submit behavior, or transcript extraction.

package/docs/adapters/browser/zhihu.md

@@ -1,30 +0,0 @@
-# Zhihu
-
-**Mode**: 🔐 Browser · **Domain**: `zhihu.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli zhihu hot` | |
-| `opencli zhihu search` | |
-| `opencli zhihu question` | |
-| `opencli zhihu download` | |
-
-## Usage Examples
-
-```bash
-# Quick start
-opencli zhihu hot --limit 5
-
-# JSON output
-opencli zhihu hot -f json
-
-# Verbose mode
-opencli zhihu hot -v
-```
-
-## Prerequisites
-
-- Chrome running and **logged into** zhihu.com
-- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/zsxq.md

@@ -1,49 +0,0 @@
-# 知识星球 (ZSXQ)
-
-**Mode**: 🔐 Browser · **Domain**: `wx.zsxq.com`
-
-Read groups, topics, search results, dynamics, and single-topic details from [知识星球](https://wx.zsxq.com) using your logged-in Chrome session.
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli zsxq groups` | List the groups your account has joined |
-| `opencli zsxq topics` | List topics in the active group |
-| `opencli zsxq topic <id>` | Fetch a single topic with comments |
-| `opencli zsxq search <keyword>` | Search topics inside a group |
-| `opencli zsxq dynamics` | List recent dynamics across groups |
-
-## Usage Examples
-
-```bash
-# List your groups
-opencli zsxq groups
-
-# List topics from the active group in Chrome
-opencli zsxq topics --limit 20
-
-# Search inside the active group
-opencli zsxq search "opencli"
-
-# Search inside a specific group explicitly
-opencli zsxq search "opencli" --group_id 123456789
-
-# Export a single topic with comments
-opencli zsxq topic 987654321 --comment_limit 20
-
-# Read recent dynamics across all joined groups
-opencli zsxq dynamics --limit 20
-```
-
-## Prerequisites
-
-- Chrome running and **logged into** [wx.zsxq.com](https://wx.zsxq.com)
-- [Browser Bridge extension](/guide/browser-bridge) installed
-
-## Notes
-
-- `zsxq topics` and `zsxq search` use the current active group context from Chrome by default
-- If there is no active group context, pass `--group_id <id>` or open the target group in Chrome first
-- `zsxq groups` returns `group_id`, which you can reuse with `--group_id`
-- `zsxq topic` surfaces a missing topic as `NOT_FOUND` instead of a generic fetch error

package/docs/adapters/desktop/antigravity.md

@@ -1,49 +0,0 @@
-# Antigravity
-
-🔥 **CLI All Electron Apps! The Most Powerful Update Has Arrived!** 🔥
-
-Turn your local Antigravity desktop application into a programmable AI node via Chrome DevTools Protocol (CDP). This allows you to compose complex LLM workflows entirely through the terminal by manipulating the actual UI natively, bypassing any API restrictions.
-
-## Prerequisites
-
-Start the Antigravity desktop app with the Chrome DevTools `remote-debugging-port` flag:
-
-```bash
-# Start Antigravity in the background
-/Applications/Antigravity.app/Contents/MacOS/Electron \
-  --remote-debugging-port=9224
-```
-
-> Depending on your installation, the executable might be named differently, e.g., `Antigravity` instead of `Electron`.
-
-Then set the target port:
-
-```bash
-export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9224"
-```
-
-## Commands
-
-### `opencli antigravity status`
-Check the Chromium CDP connection. Returns the current window title and active internal URL.
-
-### `opencli antigravity send <message>`
-Send a text prompt to the AI. Automatically locates the Lexical editor input box, types the prompt securely, and hits Enter.
-
-### `opencli antigravity read`
-Scrape the entire current conversation history block as pure text.
-
-### `opencli antigravity new`
-Click the "New Conversation" button to instantly clear the UI state and start fresh.
-
-### `opencli antigravity dump`
-Dump the current DOM and snapshot artifacts to `/tmp` for reverse-engineering and selector debugging.
-
-### `opencli antigravity extract-code`
-Extract any multi-line code blocks from the current conversation view. Ideal for automated script extraction (e.g. `opencli antigravity extract-code > script.sh`).
-
-### `opencli antigravity model <name>`
-Quickly target and switch the active LLM engine. Example: `opencli antigravity model claude` or `opencli antigravity model gemini`.
-
-### `opencli antigravity watch`
-A long-running, streaming process that continuously polls the Antigravity UI for chat updates and outputs them in real-time to standard output.

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 |