@jackwener/opencli 1.6.1 → 1.6.3

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/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`

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`).