@jackwener/opencli 1.0.1 → 1.0.4

package/docs/adapters/browser/reddit.md

@@ -0,0 +1,41 @@
+# Reddit
+
+**Mode**: 🔐 Browser · **Domain**: `reddit.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli reddit hot` | |
+| `opencli reddit frontpage` | |
+| `opencli reddit popular` | |
+| `opencli reddit search` | |
+| `opencli reddit subreddit` | |
+| `opencli reddit read` | |
+| `opencli reddit user` | |
+| `opencli reddit user-posts` | |
+| `opencli reddit user-comments` | |
+| `opencli reddit upvote` | |
+| `opencli reddit save` | |
+| `opencli reddit comment` | |
+| `opencli reddit subscribe` | |
+| `opencli reddit saved` | |
+| `opencli reddit upvoted` | |
+
+## Usage Examples
+
+```bash
+# Quick start
+opencli reddit hot --limit 5
+
+# JSON output
+opencli reddit hot -f json
+
+# Verbose mode
+opencli reddit hot -v
+```
+
+## Prerequisites
+
+- Chrome running and **logged into** reddit.com
+- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/reuters.md

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

package/docs/adapters/browser/smzdm.md

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

package/docs/adapters/browser/twitter.md

@@ -0,0 +1,47 @@
+# Twitter / X
+
+**Mode**: 🔐 Browser · **Domain**: `twitter.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli twitter trending` | |
+| `opencli twitter bookmarks` | |
+| `opencli twitter profile` | |
+| `opencli twitter search` | |
+| `opencli twitter timeline` | |
+| `opencli twitter thread` | |
+| `opencli twitter following` | |
+| `opencli twitter followers` | |
+| `opencli twitter notifications` | |
+| `opencli twitter post` | |
+| `opencli twitter reply` | |
+| `opencli twitter delete` | |
+| `opencli twitter like` | |
+| `opencli twitter article` | |
+| `opencli twitter follow` | |
+| `opencli twitter unfollow` | |
+| `opencli twitter bookmark` | |
+| `opencli twitter unbookmark` | |
+| `opencli twitter download` | |
+| `opencli twitter accept` | |
+| `opencli twitter reply-dm` | |
+
+## Usage Examples
+
+```bash
+# Quick start
+opencli twitter trending --limit 5
+
+# JSON output
+opencli twitter trending -f json
+
+# Verbose mode
+opencli twitter trending -v
+```
+
+## Prerequisites
+
+- Chrome running and **logged into** twitter.com
+- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/v2ex.md

@@ -0,0 +1,32 @@
+# V2EX
+
+**Mode**: 🌐 / 🔐 · **Domain**: `v2ex.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli v2ex hot` | |
+| `opencli v2ex latest` | |
+| `opencli v2ex topic` | |
+| `opencli v2ex daily` | |
+| `opencli v2ex me` | |
+| `opencli v2ex notifications` | |
+
+## Usage Examples
+
+```bash
+# Quick start
+opencli v2ex hot --limit 5
+
+# JSON output
+opencli v2ex hot -f json
+
+# Verbose mode
+opencli v2ex hot -v
+```
+
+## Prerequisites
+
+- Chrome running and **logged into** v2ex.com
+- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/weibo.md

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

package/docs/adapters/browser/xiaohongshu.md

@@ -0,0 +1,32 @@
+# Xiaohongshu (小红书)
+
+**Mode**: 🔐 Browser · **Domain**: `xiaohongshu.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli xiaohongshu search` | |
+| `opencli xiaohongshu notifications` | |
+| `opencli xiaohongshu feed` | |
+| `opencli xiaohongshu me` | |
+| `opencli xiaohongshu user` | |
+| `opencli xiaohongshu download` | |
+
+## Usage Examples
+
+```bash
+# Quick start
+opencli xiaohongshu search --limit 5
+
+# JSON output
+opencli xiaohongshu search -f json
+
+# Verbose mode
+opencli xiaohongshu search -v
+```
+
+## Prerequisites
+
+- Chrome running and **logged into** xiaohongshu.com
+- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/xiaoyuzhou.md

@@ -0,0 +1,28 @@
+# Xiaoyuzhou (小宇宙)
+
+**Mode**: 🌐 Public · **Domain**: `xiaoyuzhou.fm`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli xiaoyuzhou podcast` | |
+| `opencli xiaoyuzhou podcast-episodes` | |
+| `opencli xiaoyuzhou episode` | |
+
+## Usage Examples
+
+```bash
+# Quick start
+opencli xiaoyuzhou podcast --limit 5
+
+# JSON output
+opencli xiaoyuzhou podcast -f json
+
+# Verbose mode
+opencli xiaoyuzhou podcast -v
+```
+
+## Prerequisites
+
+- No browser required — uses public API

package/docs/adapters/browser/xueqiu.md

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

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

@@ -0,0 +1,26 @@
+# Yahoo Finance
+
+**Mode**: 🌐 Public · **Domain**: `finance.yahoo.com`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli yahoo-finance quote` | |
+
+## Usage Examples
+
+```bash
+# Quick start
+opencli yahoo-finance quote --limit 5
+
+# JSON output
+opencli yahoo-finance quote -f json
+
+# Verbose mode
+opencli yahoo-finance quote -v
+```
+
+## Prerequisites
+
+- No browser required — uses public API

package/docs/adapters/browser/youtube.md

@@ -0,0 +1,29 @@
+# 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/zhihu.md

@@ -0,0 +1,30 @@
+# 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/desktop/antigravity.md

@@ -0,0 +1,46 @@
+# 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 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

@@ -0,0 +1,43 @@
+# 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 read`: Copy the last AI response via `Cmd+Shift+C` and return it as text.
+
+## 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 enables future advanced commands like DOM inspection, model switching, and code extraction.
+
+## How It Works
+
+- **AppleScript mode**: Uses `osascript` and `pbcopy`/`pbpaste` for clipboard-based text transfer.
+- **CDP mode**: Connects via Chrome DevTools Protocol to the Electron renderer process.
+
+## Limitations
+
+- macOS only (AppleScript dependency)
+- AppleScript mode requires Accessibility permissions
+- `read` command copies the last response — earlier messages need manual scroll

package/docs/adapters/desktop/chatwise.md

@@ -0,0 +1,38 @@
+# 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

@@ -0,0 +1,32 @@
+# 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_CODEX_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`.
+
+### 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 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.

package/docs/adapters/desktop/cursor.md

@@ -0,0 +1,33 @@
+# 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`.
+
+### 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 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.

package/docs/adapters/desktop/discord.md

@@ -0,0 +1,28 @@
+# 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 status` | Check CDP connection |
+| `opencli discord send "message"` | Send a message in the active channel |
+| `opencli discord read` | Read recent messages |
+| `opencli discord channels` | List channels in the current server |
+| `opencli discord servers` | List all joined servers |
+| `opencli discord search "query"` | Search messages (Cmd+F) |
+| `opencli discord members` | List online members |

package/docs/adapters/desktop/feishu.md

@@ -0,0 +1,20 @@
+# Feishu (飞书/Lark)
+
+Control **Feishu/Lark Desktop** from the terminal via AppleScript.
+
+> **Note:** Feishu uses a custom `Lark Framework` (Chromium-based but NOT Electron). CDP is not available, so this adapter uses AppleScript + clipboard.
+
+## Prerequisites
+
+1. Feishu/Lark must be running and logged in
+2. Terminal must have **Accessibility permission**
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli feishu status` | Check if Feishu/Lark is running |
+| `opencli feishu send "msg"` | Send message in active chat (paste + Enter) |
+| `opencli feishu read` | Read current chat (Cmd+A → Cmd+C) |
+| `opencli feishu search "query"` | Global search (Cmd+K) |
+| `opencli feishu new` | New message/document (Cmd+N) |

package/docs/adapters/desktop/neteasemusic.md

@@ -0,0 +1,31 @@
+# NeteaseMusic (网易云音乐)
+
+Control **NeteaseMusic** (网易云音乐) from the terminal via Chrome DevTools Protocol (CDP). The app uses Chromium Embedded Framework (CEF).
+
+## Prerequisites
+
+Launch with remote debugging port:
+```bash
+/Applications/NeteaseMusic.app/Contents/MacOS/NeteaseMusic --remote-debugging-port=9234
+```
+
+## Setup
+
+```bash
+export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9234"
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli neteasemusic status` | Check CDP connection |
+| `opencli neteasemusic playing` | Current song info (title, artist, album) |
+| `opencli neteasemusic play` | Play / Pause toggle |
+| `opencli neteasemusic next` | Skip to next song |
+| `opencli neteasemusic prev` | Go to previous song |
+| `opencli neteasemusic search "query"` | Search songs, artists |
+| `opencli neteasemusic playlist` | Show current playback queue |
+| `opencli neteasemusic like` | Like / unlike current song |
+| `opencli neteasemusic lyrics` | Get lyrics of current song |
+| `opencli neteasemusic volume [0-100]` | Get or set volume |