@jackwener/opencli 1.6.2 → 1.6.3

package/docs/adapters/browser/notebooklm.md

@@ -1,69 +0,0 @@
-# NotebookLM
-
-**Mode**: 🔐 Browser Bridge · **Domain**: `notebooklm.google.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli notebooklm status` | Check whether NotebookLM is reachable in the current Chrome session |
-| `opencli notebooklm list` | List notebooks visible from the NotebookLM home page |
-| `opencli notebooklm open <notebook>` | Open one notebook in the NotebookLM automation workspace by id or URL |
-| `opencli notebooklm current` | Show metadata for the currently opened notebook in the automation workspace |
-| `opencli notebooklm get` | Get richer metadata for the current notebook |
-| `opencli notebooklm source-list` | List sources in the current notebook |
-| `opencli notebooklm source-get <source>` | Resolve one source in the current notebook by id or title |
-| `opencli notebooklm source-fulltext <source>` | Fetch extracted source fulltext through NotebookLM RPC |
-| `opencli notebooklm source-guide <source>` | Fetch guide summary and keywords for one source |
-| `opencli notebooklm history` | List conversation history threads for the current notebook |
-| `opencli notebooklm note-list` | List Studio notes visible in the current notebook |
-| `opencli notebooklm notes-get <note>` | Read the currently visible Studio note by title |
-| `opencli notebooklm summary` | Read the current notebook summary |
-
-## Compatibility Aliases
-
-| Alias | Canonical command |
-|-------|-------------------|
-| `opencli notebooklm select <notebook>` | `opencli notebooklm open <notebook>` |
-| `opencli notebooklm metadata` | `opencli notebooklm get` |
-| `opencli notebooklm notes-list` | `opencli notebooklm note-list` |
-
-## Positioning
-
-This adapter reuses the existing OpenCLI Browser Bridge runtime:
-
-- no custom NotebookLM extension
-- no exported cookie replay
-- requests and page state stay in the real Chrome session
-
-The current milestone focuses on a stable NotebookLM read surface in desktop Chrome with an already logged-in Google account.
-
-## Usage Examples
-
-```bash
-opencli notebooklm status
-opencli notebooklm list -f json
-opencli notebooklm open nb-demo -f json
-opencli notebooklm current -f json
-opencli notebooklm metadata -f json
-opencli notebooklm source-list -f json
-opencli notebooklm source-get "Quarterly report" -f json
-opencli notebooklm source-guide "Quarterly report" -f json
-opencli notebooklm source-fulltext "Quarterly report" -f json
-opencli notebooklm history -f json
-opencli notebooklm notes-list -f json
-opencli notebooklm notes-get "Draft note" -f json
-opencli notebooklm summary -f json
-```
-
-## Prerequisites
-
-- Chrome running and logged into Google / NotebookLM
-- [Browser Bridge extension](/guide/browser-bridge) installed
-- NotebookLM accessible in the current browser session
-
-## Notes
-
-- Notebook-oriented commands run in OpenCLI's owned NotebookLM automation workspace/window. Use `opencli notebooklm open <notebook>` first to choose the current notebook for follow-up commands.
-- `list`, `get`, `source-list`, `history`, `source-fulltext`, and `source-guide` prefer NotebookLM RPC paths and fall back only when the richer path is unavailable.
-- `notes-get` currently reads note content only from the visible Studio note editor; if the note is listed but not open, open it in NotebookLM first and then retry.

package/docs/adapters/browser/ones.md

@@ -1,59 +0,0 @@
-# ONES
-
-**Mode**: 🔐 Browser Bridge · **Domain**: `ones.cn` (self-hosted via `ONES_BASE_URL`)
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli ones login` | Login via Project API (`auth/login`) |
-| `opencli ones me` | Current user profile (`users/me`) |
-| `opencli ones token-info` | Token/user/team summary (`auth/token_info`) |
-| `opencli ones tasks` | Team task list with status/project labels and hours |
-| `opencli ones my-tasks` | My tasks (`assign`/`field004`/`owner`/`both`) |
-| `opencli ones task` | Task detail by UUID (`team/:team/task/:id/info`) |
-| `opencli ones worklog` | Log/backfill hours (GraphQL `addManhour` first, then REST fallbacks) |
-| `opencli ones logout` | Logout (`auth/logout`) |
-
-## Usage Examples
-
-```bash
-# Required: your ONES base URL
-export ONES_BASE_URL=https://your-instance.example.com
-
-# Optional if your deployment requires auth headers
-# export ONES_USER_ID=...
-# export ONES_AUTH_TOKEN=...
-
-# Login/profile
-opencli ones login --email you@company.com --password 'your-password'
-opencli ones me
-opencli ones token-info
-
-# Task lists
-opencli ones tasks <teamUUID> --limit 20
-opencli ones tasks <teamUUID> --project <projectUUID> --assign <userUUID>
-opencli ones my-tasks <teamUUID> --limit 100
-opencli ones my-tasks <teamUUID> --mode both
-
-# Task detail
-opencli ones task <taskUUID> --team <teamUUID>
-
-# Worklog: today / backfill
-opencli ones worklog <taskUUID> 2 --team <teamUUID>
-opencli ones worklog <taskUUID> 1.5 --team <teamUUID> --date 2026-03-23 --note "integration"
-
-opencli ones logout
-```
-
-## Prerequisites
-
-- Chrome running and logged into your ONES instance
-- [Browser Bridge extension](/guide/browser-bridge) installed
-- `ONES_BASE_URL` set to the same origin opened in Chrome
-
-## Notes
-
-- This adapter targets legacy ONES Project API deployments.
-- `ONES_TEAM_UUID` can be set to omit `--team` in `tasks` / `my-tasks` / `task`.
-- Hours display and input use `ONES_MANHOUR_SCALE` (default `100000`).

package/docs/adapters/browser/paperreview.md

@@ -1,43 +0,0 @@
-# paperreview.ai
-
-**Mode**: 🌐 Public · **Domain**: `paperreview.ai`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli paperreview submit` | Submit a PDF to paperreview.ai for review |
-| `opencli paperreview review` | Fetch a review by token |
-| `opencli paperreview feedback` | Send feedback on a completed review |
-
-## Usage Examples
-
-```bash
-# Validate a local PDF without uploading it
-opencli paperreview submit ./paper.pdf --email you@example.com --venue RAL --dry-run true
-
-# Request an upload slot but stop before the actual upload
-opencli paperreview submit ./paper.pdf --email you@example.com --venue RAL --prepare-only true
-
-# Submit a paper for review
-opencli paperreview submit ./paper.pdf --email you@example.com --venue RAL -f json
-
-# Check the review status or fetch the final review
-opencli paperreview review tok_123 -f json
-
-# Submit feedback on the review quality
-opencli paperreview feedback tok_123 --helpfulness 4 --critical-error no --actionable-suggestions yes
-```
-
-## Prerequisites
-
-- No browser required — uses public paperreview.ai endpoints
-- The input file must be a local `.pdf`
-- paperreview.ai currently rejects files larger than `10MB`
-- `submit` requires `--email`; `--venue` is optional
-
-## Notes
-
-- `submit` returns both the review token and the review URL when submission succeeds
-- `review` returns `processing` until the paperreview.ai result is ready
-- `feedback` expects `yes` / `no` values for `--critical-error` and `--actionable-suggestions`

package/docs/adapters/browser/pixiv.md

@@ -1,92 +0,0 @@
-# Pixiv
-
-**Mode**: 🔐 Browser · **Domain**: `www.pixiv.net`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli pixiv ranking` | Daily/weekly/monthly illustration rankings |
-| `opencli pixiv search <query>` | Search illustrations by keyword or tag |
-| `opencli pixiv user <uid>` | View artist profile info |
-| `opencli pixiv illusts <user-id>` | List illustrations by artist |
-| `opencli pixiv detail <id>` | View illustration details |
-| `opencli pixiv download <illust-id>` | Download original-quality images |
-
-## Usage Examples
-
-### Ranking
-
-```bash
-# Daily rankings (default)
-opencli pixiv ranking --limit 10
-
-# Weekly / monthly rankings
-opencli pixiv ranking --mode weekly
-opencli pixiv ranking --mode monthly
-
-# R18 rankings
-opencli pixiv ranking --mode daily_r18
-opencli pixiv ranking --mode weekly_r18
-
-# Other modes: rookie, original, male, female
-opencli pixiv ranking --mode rookie
-```
-
-### Search
-
-```bash
-# Search by keyword or tag
-opencli pixiv search "初音ミク" --limit 20
-
-# Filter by content rating
-opencli pixiv search "風景" --mode safe       # Safe-for-work only
-opencli pixiv search "風景" --mode r18        # R18 only
-opencli pixiv search "風景" --mode all        # All (default)
-
-# Sort by popularity
-opencli pixiv search "VOCALOID" --order popular_d
-
-# All sort options: date_d (newest), date (oldest), popular_d, popular_male_d, popular_female_d
-
-# Pagination
-opencli pixiv search "オリジナル" --page 2 --limit 30
-```
-
-### User & Illustrations
-
-```bash
-# View artist profile
-opencli pixiv user 11
-
-# List artist's illustrations (newest first)
-opencli pixiv illusts 11 --limit 10
-
-# View illustration details (tags, stats, type)
-opencli pixiv detail 12345678
-```
-
-### Download
-
-```bash
-# Download all images from an illustration
-opencli pixiv download 12345678
-
-# Download to a custom directory
-opencli pixiv download 12345678 --output ./my-images
-```
-
-### Output Formats
-
-```bash
-# JSON output
-opencli pixiv ranking -f json
-
-# Verbose mode
-opencli pixiv search "test" -v
-```
-
-## Prerequisites
-
-- Chrome running and **logged into** pixiv.net
-- [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/producthunt.md

@@ -1,49 +0,0 @@
-# Product Hunt
-
-**Mode**: 🌐 Public / 🔐 Browser · **Domain**: `www.producthunt.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli producthunt posts` | Latest Product Hunt launches (optional category filter) |
-| `opencli producthunt today` | Today's Product Hunt launches (most recent day in feed) |
-| `opencli producthunt hot` | Today's top Product Hunt launches with vote counts |
-| `opencli producthunt browse <category>` | Best products in a Product Hunt category |
-
-## Usage Examples
-
-```bash
-# Today's top launches with vote counts
-opencli producthunt hot --limit 10
-
-# Latest posts (RSS feed)
-opencli producthunt posts --limit 20
-
-# Filter by category
-opencli producthunt posts --category developer-tools --limit 10
-
-# Today's launches only
-opencli producthunt today --limit 10
-
-# Browse best products in a category
-opencli producthunt browse vibe-coding --limit 10
-opencli producthunt browse ai-agents --limit 10
-opencli producthunt browse developer-tools --limit 10
-
-# JSON output
-opencli producthunt hot -f json
-```
-
-## Category Slugs
-
-Common categories for `browse` and `posts --category`:
-
-`ai-agents`, `ai-coding-agents`, `ai-code-editors`, `ai-chatbots`, `ai-workflow-automation`,
-`vibe-coding`, `developer-tools`, `productivity`, `design-creative`, `marketing-sales`,
-`no-code-platforms`, `llms`, `finance`, `social-community`, `engineering-development`
-
-## Prerequisites
-
-- `posts` and `today` — no browser required (public RSS feed)
-- `hot` and `browse` — Chrome running with [Browser Bridge extension](/guide/browser-bridge) installed

package/docs/adapters/browser/reddit.md

@@ -1,50 +0,0 @@
-# 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
-
-# Read one subreddit
-opencli reddit subreddit python --limit 10
-
-# Read a post thread
-opencli reddit read 1abc123 --depth 2
-
-# Comment on a post
-opencli reddit comment 1abc123 "Great post"
-
-# 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

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

@@ -1,36 +0,0 @@
-# 新浪博客 (Sina Blog)
-
-**Mode**: 🌐 Public (search) / 🔐 Browser (hot, article, user) · **Domain**: `blog.sina.com.cn`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli sinablog hot` | 获取新浪博客热门文章/推荐 |
-| `opencli sinablog search` | 搜索新浪博客文章（通过新浪搜索，无需浏览器） |
-| `opencli sinablog article` | 获取新浪博客单篇文章详情 |
-| `opencli sinablog user` | 获取新浪博客用户的文章列表 |
-
-## Usage Examples
-
-```bash
-# 热门文章
-opencli sinablog hot --limit 10
-
-# 搜索文章（公开 API，无需浏览器）
-opencli sinablog search "人工智能"
-
-# 文章详情
-opencli sinablog article "https://blog.sina.com.cn/s/blog_xxx.html"
-
-# 用户文章列表
-opencli sinablog user 1234567890 --limit 10
-
-# JSON output
-opencli sinablog hot -f json
-```
-
-## Prerequisites
-
-- `search` command: No login required (public API)
-- `hot`, `article`, `user` commands: Chrome with `blog.sina.com.cn` accessible, Browser Bridge extension installed

package/docs/adapters/browser/sinafinance.md

@@ -1,115 +0,0 @@
-# 新浪财经 (Sina Finance)
-
-**Mode**: 🌐 Public / 🔐 Browser · **Domain**: `finance.sina.com.cn`
-
-## Commands
-
-| Command | Description | Mode |
-|---------|-------------|------|
-| `opencli sinafinance news` | 新浪财经 7×24 小时实时快讯 | 🌐 Public |
-| `opencli sinafinance rolling-news` | 新浪财经滚动新闻 | 🔐 Browser |
-| `opencli sinafinance stock` | 新浪财经行情（A股/港股/美股） | 🌐 Public |
-| `opencli sinafinance stock-rank` | 新浪财经热搜榜 | 🔐 Browser |
-
-## Usage Examples
-
-### news - 7×24 实时快讯
-
-```bash
-# Latest financial news
-opencli sinafinance news --limit 20
-
-# Filter by type
-opencli sinafinance news --type 1   # A股
-opencli sinafinance news --type 2   # 宏观
-opencli sinafinance news --type 6   # 国际
-
-# JSON output
-opencli sinafinance news -f json
-```
-
-### rolling-news - 滚动新闻
-
-```bash
-# Rolling news feed
-opencli sinafinance rolling-news
-
-# JSON output
-opencli sinafinance rolling-news -f json
-```
-
-### stock - 股票行情
-
-```bash
-# Search and view A-share stock
-opencli sinafinance stock 贵州茅台 --market cn
-
-# Search and view HK stock
-opencli sinafinance stock 腾讯控股 --market hk
-
-# Search and view US stock
-opencli sinafinance stock aapl --market us
-
-# Auto-detect market (searches cn, hk, us in order)
-opencli sinafinance stock 招商证券
-
-# JSON output
-opencli sinafinance stock 贵州茅台 -f json
-```
-
-### stock-rank - 热搜榜
-
-```bash
-# Default A股热搜榜
-opencli sinafinance stock-rank
-
-# 港股热搜榜
-opencli sinafinance stock-rank --market hk
-
-# 美股热搜榜
-opencli sinafinance stock-rank --market us
-
-# 外汇热搜榜
-opencli sinafinance stock-rank --market ft
-
-# 期货热搜榜
-opencli sinafinance stock-rank --market wh
-
-# JSON output
-opencli sinafinance stock-rank -f json
-```
-
-## Options
-
-### news
-
-| Option | Description |
-|--------|-------------|
-| `--limit` | Max results, up to 50 (default: 20) |
-| `--type` | News type: `0`=全部, `1`=A股, `2`=宏观, `3`=公司, `4`=数据, `5`=市场, `6`=国际, `7`=观点, `8`=央行, `9`=其它 |
-
-### stock
-
-| Option | Description |
-|--------|-------------|
-| `--market` | Market: `cn`, `hk`, `us`, `auto` (default: auto). When `auto`, searches in cn, hk, us order |
-
-### stock-rank
-
-| Option | Description |
-|--------|-------------|
-| `--market` | Market: `cn` (A股, 默认), `ft` (期货), `us` (美股), `wh` (外汇), `hk` (港股) |
-
-## Prerequisites
-
-- `news` & `stock`: No browser required — uses public API
-- `rolling-news` & `stock-rank`: Chrome running and **logged into** `finance.sina.com.cn`
-- For `rolling-news` & `stock-rank`: [Browser Bridge extension](/guide/browser-bridge) installed
-
-## Notes
-
-- `news` and `stock` use public APIs — no browser or login needed
-- `stock` supports Chinese names, Chinese codes, and ticker symbols; auto-detects market
-- Market priority for auto-detection: cn (A股) → hk (港股) → us (美股)
-- US stock `High`/`Low` columns show 52-week range; A股/港股 show today's range
-- `stock-rank` scrapes the hot search list from the Sina Finance homepage; requires browser login

package/docs/adapters/browser/smzdm.md

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

@@ -1,62 +0,0 @@
-# Spotify
-
-**Mode**: 🔑 OAuth API · **Domains**: `accounts.spotify.com`, `api.spotify.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli spotify auth` | Authenticate with Spotify and store tokens locally |
-| `opencli spotify status` | Show current playback status |
-| `opencli spotify play [query]` | Resume playback or search-and-play a track |
-| `opencli spotify pause` | Pause playback |
-| `opencli spotify next` | Skip to the next track |
-| `opencli spotify prev` | Skip to the previous track |
-| `opencli spotify volume <0-100>` | Set playback volume |
-| `opencli spotify search <query>` | Search Spotify tracks |
-| `opencli spotify queue <query>` | Add a track to the playback queue |
-| `opencli spotify shuffle <on|off>` | Toggle shuffle |
-| `opencli spotify repeat <off|track|context>` | Set repeat mode |
-
-## Usage Examples
-
-```bash
-# First-time setup
-opencli spotify auth
-
-# What is playing right now?
-opencli spotify status
-
-# Resume playback
-opencli spotify play
-
-# Search and immediately play a track
-opencli spotify play "Numb Linkin Park"
-
-# Search without playing
-opencli spotify search "Daft Punk" --limit 5 -f json
-
-# Queue a track
-opencli spotify queue "Get Lucky"
-
-# Playback controls
-opencli spotify pause
-opencli spotify next
-opencli spotify prev
-opencli spotify volume 35
-opencli spotify shuffle on
-opencli spotify repeat track
-```
-
-## Setup
-
-1. Create a Spotify app at <https://developer.spotify.com/dashboard>
-2. Add `http://127.0.0.1:8888/callback` to the app's Redirect URIs
-3. Fill in `SPOTIFY_CLIENT_ID` and `SPOTIFY_CLIENT_SECRET` in `~/.opencli/spotify.env`
-4. Run `opencli spotify auth`
-
-## Notes
-
-- Browser Bridge is not required.
-- Tokens are stored locally at `~/.opencli/spotify-tokens.json`.
-- Playback commands work best when you already have an active Spotify device/session.

package/docs/adapters/browser/stackoverflow.md

@@ -1,35 +0,0 @@
-# Stack Overflow
-
-**Mode**: 🌐 Public · **Domain**: `stackoverflow.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli stackoverflow hot` | Hot questions |
-| `opencli stackoverflow search` | Search questions |
-| `opencli stackoverflow bounties` | Questions with active bounties |
-| `opencli stackoverflow unanswered` | Unanswered questions |
-
-## Usage Examples
-
-```bash
-# Hot questions
-opencli stackoverflow hot --limit 10
-
-# Search questions
-opencli stackoverflow search "async await" --limit 20
-
-# Active bounties
-opencli stackoverflow bounties --limit 10
-
-# Unanswered questions
-opencli stackoverflow unanswered --limit 10
-
-# JSON output
-opencli stackoverflow hot -f json
-```
-
-## Prerequisites
-
-- No browser required — uses public Stack Exchange API

package/docs/adapters/browser/steam.md

@@ -1,26 +0,0 @@
-# Steam
-
-**Mode**: 🌐 Public · **Domain**: `store.steampowered.com`
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `opencli steam top-sellers` | Top selling games on Steam |
-
-## Usage Examples
-
-```bash
-# Quick start
-opencli steam top-sellers
-
-# Limit results
-opencli steam top-sellers --limit 5
-
-# JSON output
-opencli steam top-sellers -f json
-```
-
-## Prerequisites
-
-- No login required (public API)