@jackwener/opencli 1.6.2 → 1.6.3

package/docs/adapters/browser/grok.md

@@ -1,53 +0,0 @@
-# Grok
-
-**Mode**: Default Grok adapter + optional explicit consumer web path · **Domain**: `grok.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli grok ask` | Keep the default Grok ask behavior |
-| `opencli grok ask --web` | Use the explicit grok.com consumer web UI flow |
-
-## Usage Examples
-
-```bash
-# Default / compatibility path
-opencli grok ask --prompt "Explain quantum computing in simple terms"
-
-# Explicit consumer web path
-opencli grok ask --prompt "Explain quantum computing in simple terms" --web
-
-# Best-effort fresh chat on the consumer web path
-opencli grok ask --prompt "Hello" --web --new
-
-# Set custom timeout (default: 120s)
-opencli grok ask --prompt "Write a long essay" --web --timeout 180
-```
-
-### Options
-
-| Option | Description |
-|--------|-------------|
-| `--prompt` | The message to send (required) |
-| `--timeout` | Wait timeout in seconds (default: 120) |
-| `--new` | Start a new chat before sending (default: false) |
-| `--web` | Opt into the explicit grok.com consumer web flow (default: false) |
-
-## Behavior
-
-- `opencli grok ask` keeps the upstream/default behavior intact.
-- `opencli grok ask --web` switches to the newer hardened consumer-web implementation.
-- The `--web` path adds stricter composer detection, clearer blocked/session-gated hints, and waits for a stabilized assistant bubble before returning.
-
-## Prerequisites
-
-- The Grok adapter still depends on browser-backed access to `grok.com`
-- For `--web`, Chrome should already be running with an authenticated Grok consumer session
-- [Browser Bridge extension](/guide/browser-bridge) installed
-
-## Caveats
-
-- `--web` drives the Grok consumer web UI in the browser, not an API.
-- It depends on an already-authenticated session and can fail if Grok shows login, challenge, rate-limit, or other session-gating UI.
-- It may break when the Grok composer DOM, submit button behavior, or message bubble structure changes.

package/docs/adapters/browser/hackernews.md

@@ -1,42 +0,0 @@
-# HackerNews
-
-**Mode**: 🌐 Public · **Domain**: `news.ycombinator.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli hackernews top` | Hacker News top stories |
-| `opencli hackernews new` | Hacker News newest stories |
-| `opencli hackernews best` | Hacker News best stories |
-| `opencli hackernews ask` | Hacker News Ask HN posts |
-| `opencli hackernews show` | Hacker News Show HN posts |
-| `opencli hackernews jobs` | Hacker News job postings |
-| `opencli hackernews search <query>` | Search Hacker News stories |
-| `opencli hackernews user <username>` | Hacker News user profile |
-
-## Usage Examples
-
-```bash
-# Top stories
-opencli hackernews top --limit 5
-
-# Newest stories
-opencli hackernews new --limit 10
-
-# Search stories
-opencli hackernews search "machine learning" --limit 5
-
-# User profile
-opencli hackernews user pg
-
-# JSON output
-opencli hackernews top -f json
-
-# Sort search by date
-opencli hackernews search "rust" --sort date
-```
-
-## Prerequisites
-
-- No browser required — uses public API

package/docs/adapters/browser/hf.md

@@ -1,42 +0,0 @@
-# Hugging Face
-
-**Mode**: 🌐 Public · **Domain**: `huggingface.co`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli hf top` | Top upvoted Hugging Face papers |
-
-## Usage Examples
-
-```bash
-# Today's top papers
-opencli hf top --limit 10
-
-# All papers (no limit)
-opencli hf top --all
-
-# Specific date
-opencli hf top --date 2025-03-01
-
-# Weekly/monthly top papers
-opencli hf top --period weekly
-opencli hf top --period monthly
-
-# JSON output
-opencli hf top -f json
-```
-
-### Options
-
-| Option | Description |
-|--------|-------------|
-| `--limit` | Number of papers (default: 20) |
-| `--all` | Return all papers, ignoring limit |
-| `--date` | Date in `YYYY-MM-DD` format (defaults to most recent) |
-| `--period` | Time period: `daily`, `weekly`, or `monthly` (default: daily) |
-
-## Prerequisites
-
-- No browser required — uses public Hugging Face API

package/docs/adapters/browser/hupu.md

@@ -1,53 +0,0 @@
-# Hupu (虎扑)
-
-**Mode**: 🌐 Public / 🔐 Browser · **Domain**: `bbs.hupu.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli hupu hot` | Read Hupu hot threads |
-| `opencli hupu search <keyword>` | Search Hupu threads by keyword |
-| `opencli hupu detail <tid>` | Read one thread and optional hot replies |
-| `opencli hupu reply <tid> <text>` | Reply to a thread or quote one reply |
-| `opencli hupu like <tid> <pid>` | Like one reply |
-| `opencli hupu unlike <tid> <pid>` | Cancel like on one reply |
-
-## Usage Examples
-
-```bash
-# Hot threads
-opencli hupu hot --limit 5
-
-# Search threads
-opencli hupu search 湖人 --limit 10
-
-# Read one thread and include hot replies
-opencli hupu detail 638234927 --replies true
-
-# Reply to the thread
-opencli hupu reply 638234927 "hello from opencli" --topic_id 502
-
-# Quote one hot reply by pid
-opencli hupu reply 638234927 "replying to this comment" --topic_id 502 --quote_id 174908
-
-# Like / unlike one reply
-opencli hupu like 638234927 174908 --fid 4860
-opencli hupu unlike 638234927 174908 --fid 4860
-
-# JSON output
-opencli hupu detail 638234927 -f json
-```
-
-## Notes
-
-- `reply --topic_id` maps to Hupu's API `topicId`, for example `502` for Basketball News
-- `reply --quote_id` is the quoted reply `pid`
-- `like` / `unlike --fid` uses the forum ID from thread metadata
-- `detail --replies true` appends top hot replies to the content field
-
-## Prerequisites
-
-- Chrome running and able to open `bbs.hupu.com`
-- [Browser Bridge extension](/guide/browser-bridge) installed
-- For `reply`, `like`, and `unlike`, a valid Hupu login session in Chrome is required

package/docs/adapters/browser/imdb.md

@@ -1,47 +0,0 @@
-# IMDb
-
-**Mode**: 🌐 Public (Browser) · **Domain**: `www.imdb.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli imdb search` | Search movies, TV shows, and people |
-| `opencli imdb title` | Get movie or TV show details |
-| `opencli imdb top` | IMDb Top 250 Movies |
-| `opencli imdb trending` | IMDb Most Popular Movies |
-| `opencli imdb person` | Get actor or director info |
-| `opencli imdb reviews` | Get user reviews for a title |
-
-## Usage Examples
-
-```bash
-# Search for a movie
-opencli imdb search "inception" --limit 10
-
-# Get movie details
-opencli imdb title tt1375666
-
-# Get TV series details (also accepts full URL)
-opencli imdb title "https://www.imdb.com/title/tt0903747/"
-
-# Top 250 movies
-opencli imdb top --limit 20
-
-# Currently trending movies
-opencli imdb trending --limit 10
-
-# Actor/director info with filmography
-opencli imdb person nm0634240 --limit 5
-
-# User reviews
-opencli imdb reviews tt1375666 --limit 5
-
-# JSON output
-opencli imdb top --limit 5 -f json
-```
-
-## Prerequisites
-
-- Chrome with Browser Bridge extension installed
-- No login required (all data is public)

package/docs/adapters/browser/instagram.md

@@ -1,46 +0,0 @@
-# Instagram
-
-**Mode**: 🔐 Browser · **Domain**: `instagram.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli instagram profile` | Get user profile info |
-| `opencli instagram search` | Search users |
-| `opencli instagram user` | Get recent posts from a user |
-| `opencli instagram explore` | Discover trending posts |
-| `opencli instagram followers` | List user's followers |
-| `opencli instagram following` | List user's following |
-| `opencli instagram saved` | Get your saved posts |
-
-## Usage Examples
-
-```bash
-# View a user's profile
-opencli instagram profile nasa
-
-# Search users
-opencli instagram search nasa --limit 5
-
-# View a user's recent posts
-opencli instagram user nasa --limit 10
-
-# Discover trending posts
-opencli instagram explore --limit 20
-
-# List followers/following
-opencli instagram followers nasa --limit 20
-opencli instagram following nasa --limit 20
-
-# Get your saved posts
-opencli instagram saved --limit 10
-
-# JSON output
-opencli instagram profile nasa -f json
-```
-
-## Prerequisites
-
-- Chrome running and **logged into** instagram.com
-- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/jd.md

@@ -1,27 +0,0 @@
-# JD.com
-
-**Mode**: 🔐 Browser · **Domain**: `item.jd.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli jd item <sku>` | Fetch product details (price, shop, specs, AVIF images) |
-
-## Usage Examples
-
-```bash
-# Get product details by SKU
-opencli jd item 100291143898
-
-# Limit returned AVIF images
-opencli jd item 100291143898 --images 5
-
-# JSON output
-opencli jd item 100291143898 -f json
-```
-
-## Prerequisites
-
-- Chrome running and **logged into** jd.com
-- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/jike.md

@@ -1,45 +0,0 @@
-# 即刻 (Jike)
-
-**Mode**: 🔐 Browser · **Domain**: `web.okjike.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli jike feed` | 即刻首页动态流 |
-| `opencli jike search` | 搜索即刻帖子 |
-| `opencli jike post` | 帖子详情及评论 |
-| `opencli jike topic` | 话题详情 |
-| `opencli jike user` | 用户资料 |
-| `opencli jike create` | 发布即刻动态 |
-| `opencli jike comment` | 评论即刻帖子 |
-| `opencli jike like` | 点赞即刻帖子 |
-| `opencli jike repost` | 转发即刻帖子 |
-| `opencli jike notifications` | 即刻通知 |
-
-## Usage Examples
-
-```bash
-# View feed
-opencli jike feed --limit 10
-
-# Search posts
-opencli jike search "AI" --limit 20
-
-# View post details and comments
-opencli jike post <post-id>
-
-# Create a new post
-opencli jike create --content "Hello Jike!"
-
-# Like a post
-opencli jike like <post-id>
-
-# JSON output
-opencli jike feed -f json
-```
-
-## Prerequisites
-
-- Chrome running and **logged into** web.okjike.com
-- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/jimeng.md

@@ -1,39 +0,0 @@
-# 即梦AI (Jimeng)
-
-**Mode**: 🔐 Browser · **Domain**: `jimeng.jianying.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli jimeng generate` | 即梦AI 文生图 — 输入 prompt 生成图片 |
-| `opencli jimeng history` | 查看生成历史 |
-
-## Usage Examples
-
-```bash
-# Generate an image
-opencli jimeng generate --prompt "一只在星空下的猫"
-
-# Use a specific model
-opencli jimeng generate --prompt "cyberpunk city" --model high_aes_general_v50
-
-# Set custom wait timeout
-opencli jimeng generate --prompt "sunset landscape" --wait 60
-
-# View generation history
-opencli jimeng history --limit 10
-```
-
-### Options (generate)
-
-| Option | Description |
-|--------|-------------|
-| `--prompt` | Image description prompt (required) |
-| `--model` | Model: `high_aes_general_v50` (5.0 Lite), `high_aes_general_v42` (4.6), `high_aes_general_v40` (4.0) |
-| `--wait` | Wait seconds for generation (default: 40) |
-
-## Prerequisites
-
-- Chrome running and **logged into** jimeng.jianying.com
-- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/linkedin.md

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

package/docs/adapters/browser/linux-do.md

@@ -1,206 +0,0 @@
-# LINUX DO
-
-**Mode**: 🔐 Browser · **Domain**: `linux.do`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli linux-do feed` | Browse topics (site-wide, by tag, or by category) |
-| `opencli linux-do categories` | List all categories |
-| `opencli linux-do tags` | List popular tags |
-| `opencli linux-do search <query>` | Search topics |
-| `opencli linux-do topic <id>` | View topic posts |
-| `opencli linux-do user-topics <username>` | Topics created by a user |
-| `opencli linux-do user-posts <username>` | Replies posted by a user |
-
-## feed
-
-Browse topic listings. Defaults to latest topics when called with no arguments.
-
-- Supports filtering by `--tag`, `--category`, or both
-- `--tag` accepts tag name, slug, or ID
-- `--category` accepts category name, slug, ID, or `Parent / Child` path for sub-categories
-- Use `--view` to switch between latest / hot / top
-
-### Basic
-
-```bash
-# Latest topics (default)
-opencli linux-do feed
-
-# Hot topics
-opencli linux-do feed --view hot
-
-# Top topics — default period is weekly
-opencli linux-do feed --view top
-opencli linux-do feed --view top --period daily
-opencli linux-do feed --view top --period monthly
-
-# Sort by views descending
-opencli linux-do feed --order views
-
-# Sort by created time ascending
-opencli linux-do feed --order created --ascending
-
-# Limit results
-opencli linux-do feed --limit 10
-
-# JSON output
-opencli linux-do feed -f json
-```
-
-### Filter by tag
-
-```bash
-# By tag name, slug, or ID — all equivalent
-opencli linux-do feed --tag "ChatGPT"
-opencli linux-do feed --tag chatgpt
-opencli linux-do feed --tag 3
-
-# Tag + hot view
-opencli linux-do feed --tag "ChatGPT" --view hot
-
-# Tag + top view with period
-opencli linux-do feed --tag "OpenAI" --view top --period monthly
-```
-
-### Filter by category
-
-Supports both top-level and sub-categories. Sub-categories auto-resolve their parent path.
-
-```bash
-# Top-level category — name, slug, or ID
-opencli linux-do feed --category "开发调优"
-opencli linux-do feed --category develop
-opencli linux-do feed --category 4
-
-# Sub-category
-opencli linux-do feed --category "开发调优 / Lv1"
-opencli linux-do feed --category "网盘资源"
-
-# Category + hot / top view
-opencli linux-do feed --category "开发调优" --view hot
-opencli linux-do feed --category "开发调优" --view top --period weekly
-```
-
-### Category + tag
-
-Combine `--category` and `--tag` to narrow results within a category.
-
-```bash
-opencli linux-do feed --category "开发调优" --tag "ChatGPT"
-opencli linux-do feed --category "网盘资源" --tag "OpenAI"
-opencli linux-do feed --category 94 --tag 4 --view top --period monthly
-```
-
-### Parameters
-
-| Parameter | Description | Default |
-|-----------|-------------|---------|
-| `--view V` | `latest`, `hot`, `top` | `latest` |
-| `--tag VALUE` | Tag name, slug, or ID | — |
-| `--category VALUE` | Category name, slug, or ID | — |
-| `--limit N` | Number of results | `20` |
-| `--order O` | `default`, `created`, `activity`, `views`, `posts`, `category`, `likes`, `op_likes`, `posters` | `default` |
-| `--ascending` | Sort ascending instead of descending | off |
-| `--period P` | `all`, `daily`, `weekly`, `monthly`, `quarterly`, `yearly` (only with `--view top`) | `weekly` |
-
-Output columns: `title`, `replies`, `created`, `likes`, `views`, `url`
-
-## categories
-
-List forum categories with optional sub-category expansion.
-
-```bash
-opencli linux-do categories
-opencli linux-do categories --subcategories
-opencli linux-do categories --limit 50
-```
-
-When `--subcategories` is enabled, sub-categories are rendered as `Parent / Child` so the `name` value can be copied directly into `opencli linux-do feed --category ...`.
-
-Output columns: `name`, `slug`, `id`, `topics`, `description`
-
-## tags
-
-List tags sorted by usage count.
-
-```bash
-opencli linux-do tags
-opencli linux-do tags --limit 50
-```
-
-Output columns: `rank`, `name`, `count`, `url`
-
-## search
-
-Search topics by keyword.
-
-```bash
-opencli linux-do search "NixOS"
-opencli linux-do search "Docker" --limit 10
-opencli linux-do search "Claude" -f json
-```
-
-Output columns: `rank`, `title`, `views`, `likes`, `replies`, `url`
-
-## topic
-
-View posts within a topic (first page).
-
-```bash
-opencli linux-do topic 1234
-opencli linux-do topic 1234 --limit 50
-opencli linux-do topic 1234 --main_only -f json | jq -r '.[0].content'
-```
-
-Notes:
-- `--main_only` returns only the main post row and keeps the body untruncated
-
-Output columns: `author`, `content`, `likes`, `created_at`
-
-## user-topics
-
-List topics created by a user.
-
-```bash
-opencli linux-do user-topics neo
-opencli linux-do user-topics neo --limit 10
-```
-
-Output columns: `rank`, `title`, `replies`, `created_at`, `likes`, `views`, `url`
-
-## user-posts
-
-List replies posted by a user.
-
-```bash
-opencli linux-do user-posts neo
-opencli linux-do user-posts neo --limit 10
-```
-
-Output columns: `index`, `topic_user`, `topic`, `reply`, `time`, `url`
-
-## Compatibility
-
-The legacy commands below are still available as compatibility wrappers while `feed` becomes the canonical entrypoint:
-
-```bash
-opencli linux-do latest
-opencli linux-do hot --period weekly
-opencli linux-do category develop 4
-```
-
-Preferred modern forms:
-
-```bash
-opencli linux-do feed --view latest
-opencli linux-do feed --view top --period weekly
-opencli linux-do feed --category 4
-```
-
-## Prerequisites
-
-- Chrome running and **logged into** linux.do
-- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/lobsters.md

@@ -1,32 +0,0 @@
-# Lobsters
-
-**Mode**: 🌐 Public · **Domain**: `lobste.rs`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli lobsters hot` | Hottest stories |
-| `opencli lobsters newest` | Latest stories |
-| `opencli lobsters active` | Most active discussions |
-| `opencli lobsters tag` | Stories by tag |
-
-## Usage Examples
-
-```bash
-# Quick start
-opencli lobsters hot --limit 10
-
-# Filter by tag
-opencli lobsters tag --tag rust --limit 5
-
-# JSON output
-opencli lobsters hot -f json
-
-# Verbose mode
-opencli lobsters hot -v
-```
-
-## Prerequisites
-
-None — all commands use the public JSON API, no browser or login required.

package/docs/adapters/browser/medium.md

@@ -1,32 +0,0 @@
-# Medium
-
-**Mode**: 🌗 Mixed · **Domain**: `medium.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli medium feed` | Get hot Medium posts, optionally scoped to a topic |
-| `opencli medium search` | Search Medium posts by keyword |
-| `opencli medium user` | Get recent articles by a user |
-
-## Usage Examples
-
-```bash
-# Get the general Medium feed
-opencli medium feed --limit 10
-
-# Search posts by keyword
-opencli medium search ai
-
-# Get articles by a user
-opencli medium user @username
-
-# Topic feed as JSON
-opencli medium feed --topic programming -f json
-```
-
-## Prerequisites
-
-- `opencli medium search` can run without a browser
-- `opencli medium feed` and `opencli medium user` require Browser Bridge access to `medium.com`