OpenCLI Usage Guide
Make any website or Electron App your CLI. Reuse Chrome login, zero risk, AI-powered discovery.
Install & Run
# npm global install (recommended)
npm install -g @jackwener/opencli
opencli <command>
# Or from source
cd ~/code/opencli && npm install
npx tsx src/main.ts <command>
# Update to latest
npm update -g @jackwener/opencli
Prerequisites
Browser commands require:
- Chrome browser running (logged into target sites)
- opencli Browser Bridge Chrome extension installed (load
extension/ as unpacked in chrome://extensions)
- No further setup needed — the daemon auto-starts on first browser command
Note: You must be logged into the target website in Chrome before running commands. Tabs opened during command execution are auto-closed afterwards.
Public API commands (hackernews, v2ex) need no browser.
Quick Lookup by Capability
| Capability |
Platforms (partial list) |
| search |
Bilibili, Twitter, Reddit, Xiaohongshu, Zhihu, YouTube, Google, arXiv, LinkedIn, Pixiv, etc. |
| hot/trending |
Bilibili, Twitter, Weibo, HackerNews, Reddit, V2EX, Xueqiu, Lobsters, Douban |
| feed/timeline |
Twitter, Reddit, Xiaohongshu, Xueqiu, Jike, Facebook, Instagram, Medium |
| user/profile |
Twitter, Reddit, Instagram, TikTok, Facebook, Bilibili, Pixiv |
| post/create |
Twitter, Jike, Douyin, Weibo |
| AI chat |
Grok, Doubao, ChatGPT, Gemini, Cursor, Codex, NotebookLM |
| finance/stock |
Xueqiu, Yahoo Finance, Barchart, Sina Finance, Bloomberg |
| web scraping |
opencli web read --url <url> — any URL to Markdown |
| GitHub/DevOps |
opencli gh, opencli docker, opencli vercel — external CLI passthrough |
| collaboration |
opencli lark-cli, opencli dws, opencli wecom-cli — external CLI passthrough |
Command Quick Reference
Usage: opencli <site> <command> [args] [--limit N] [-f json|yaml|md|csv|table]
Type legend: 🌐 = Browser (needs Chrome login) · ✅ = Public API (no browser) · 🖥️ = Desktop (Electron/CDP) · 🔧 = External CLI (passthrough)
Website Adapters
| Site |
Type |
Commands |
| 1688 |
🌐 |
search item download store |
| 36kr |
🌐 |
hot news search article |
| amazon |
🌐 |
bestsellers search product offer discussion movers-shakers new-releases |
| apple-podcasts |
✅ |
top search episodes |
| arxiv |
✅ |
search paper |
| band |
🌐 |
bands posts post mentions |
| barchart |
🌐 |
quote options greeks flow |
| bbc |
✅ |
news |
| bilibili |
🌐 |
hot search me favorite history feed user-videos subtitle dynamic ranking following |
| bloomberg |
✅🌐 |
RSS: main markets tech politics economics opinions industries businessweek feeds · Browser: news (full article) |
| bluesky |
🌐 |
search profile user feeds followers following thread trending starter-packs |
| boss |
🌐 |
search detail recommend joblist greet batchgreet send chatlist chatmsg invite mark exchange resume stats |
| chaoxing |
🌐 |
assignments exams |
| coupang |
🌐 |
search add-to-cart |
| ctrip |
🌐 |
search |
| devto |
✅ |
top tag user |
| dictionary |
✅ |
search synonyms examples |
| doubao |
🌐 |
status new send read ask detail history meeting-summary meeting-transcript |
| douban |
🌐 |
search top250 subject photos download marks reviews movie-hot book-hot |
| douyin |
🌐 |
profile videos user-videos activities collections hashtag location stats publish draft drafts delete update |
| facebook |
🌐 |
feed profile search friends groups events notifications memories add-friend join-group |
| gemini |
🌐 |
ask new image deep-research deep-research-result |
| google |
✅ |
news search suggest trends |
| grok |
🌐 |
ask |
| hackernews |
✅ |
top new best ask show jobs search user |
| hf |
✅ |
top |
| hupu |
🌐 |
hot search detail like unlike reply mentions |
| imdb |
✅ |
top trending search title person reviews |
| instagram |
🌐 |
explore profile search user followers following follow unfollow like unlike comment save unsave saved |
| jd |
🌐 |
item |
| jianyu |
🌐 |
search |
| jike |
🌐 |
feed search create like comment repost notifications post topic user |
| jimeng |
🌐 |
generate history |
| lesswrong |
✅ |
frontpage curated new top top-week top-month top-year shortform read comments user user-posts sequences tags tag |
| linkedin |
🌐 |
search timeline |
| linux-do |
🌐 |
hot latest feed search categories category tags topic topic-content user-posts user-topics |
| lobsters |
✅ |
hot newest active tag |
| medium |
🌐 |
feed search user |
| notebooklm |
🌐 |
status list open current get history summary note-list notes-get source-list source-get source-fulltext source-guide |
| ones |
🌐 |
login logout me tasks task my-tasks worklog token-info |
| paperreview |
✅ |
submit review feedback |
| pixiv |
🌐 |
ranking search user illusts detail download |
| producthunt |
✅ |
today hot browse posts |
| quark |
🌐 |
ls mkdir mv rename rm save share-tree |
| reddit |
🌐 |
hot frontpage popular search subreddit read user user-posts user-comments upvote save comment subscribe saved upvoted |
| reuters |
🌐 |
search |
| sinablog |
🌐 |
hot search article user |
| sinafinance |
✅ |
news |
| smzdm |
🌐 |
search |
| spotify |
✅ |
auth status play pause next prev volume search queue shuffle repeat |
| stackoverflow |
✅ |
hot search bounties unanswered |
| steam |
✅ |
top-sellers |
| substack |
🌐 |
feed search publication |
| tieba |
🌐 |
hot search posts read |
| tiktok |
🌐 |
explore search profile user following follow unfollow like unlike comment save unsave live notifications friends |
| twitter |
🌐 |
trending bookmarks search profile timeline thread article follow unfollow bookmark unbookmark post like likes reply delete block unblock followers following notifications hide-reply download accept reply-dm |
| v2ex |
✅🌐 |
Public: hot latest topic node nodes member user replies · Browser: daily me notifications |
| web |
🌐 |
read — any URL to Markdown |
| weibo |
🌐 |
hot search feed user me post comments |
| weixin |
🌐 |
download — 公众号 article to Markdown |
| weread |
🌐 |
shelf search book highlights notes notebooks ranking |
| wikipedia |
✅ |
search summary random trending |
| xianyu |
🌐 |
search item chat |
| xiaoe |
🌐 |
courses catalog content detail play-url |
| xiaohongshu |
🌐 |
search notifications feed user note comments download publish creator-notes creator-note-detail creator-notes-summary creator-profile creator-stats |
| xiaoyuzhou |
✅ |
podcast podcast-episodes episode |
| xueqiu |
🌐 |
hot-stock stock watchlist feed hot search comments earnings-date fund-holdings fund-snapshot |
| yahoo-finance |
🌐 |
quote |
| yollomi |
🌐 |
models generate video upload remove-bg edit background face-swap object-remover restore try-on upscale |
| youtube |
🌐 |
search video transcript |
| yuanbao |
🌐 |
new ask |
| zhihu |
🌐 |
hot search question |
| zsxq |
🌐 |
groups dynamics topics topic search |
Desktop Apps (CDP/Electron)
| App |
Commands |
| antigravity |
status send read new dump extract-code model watch |
| chatgpt |
status new send read ask model |
| chatwise |
status new send read ask model history export screenshot |
| codex |
status send read new dump extract-diff model ask screenshot history export |
| cursor |
status send read new dump composer model extract-code ask screenshot history export |
| discord-app |
status send read channels servers search members |
| doubao-app |
status new send read ask screenshot dump |
| notion |
status search read new write sidebar favorites export |
External CLI (passthrough)
OpenCLI can discover, auto-install, and passthrough commands to external CLI tools. Use opencli install <name> to auto-install, or opencli register <name> to register a local CLI.
| CLI |
Description |
Commands |
| gh |
GitHub CLI — repos, PRs, issues, releases |
repo pr issue (all gh subcommands) |
| obsidian |
Obsidian vault — notes, search, tags |
All obsidian subcommands |
| docker |
Docker CLI |
All docker subcommands |
| lark-cli |
Lark/Feishu — messages, docs, calendar, tasks (200+ commands) |
All lark-cli subcommands |
| dws |
DingTalk Workspace — messages, docs, calendar, contacts |
All dws subcommands |
| wecom-cli |
WeCom/企业微信 — contacts, todos, meetings, messages |
All wecom-cli subcommands |
| vercel |
Vercel — deploy, domains, env vars, logs |
All vercel subcommands |
opencli install gh # Auto-install gh CLI
opencli register my-tool # Register a local custom CLI
opencli gh pr list --limit 5 # Passthrough to gh
opencli docker ps # Passthrough to docker
opencli lark-cli msg send ... # Passthrough to lark-cli
Management
opencli list [-f json|yaml] # List all commands
opencli validate [site] # Validate adapter definitions
opencli doctor # Diagnose browser bridge
opencli explore <url> # AI-powered API discovery
opencli record <url> # Record API calls manually
All commands support: --format / -f with table json yaml md csv
Self-Repair
If a command fails due to a site change (selector, API, or response schema), automatically fix the adapter and retry instead of reporting failure. Re-run the command with OPENCLI_DIAGNOSTIC=1 to get structured diagnostic context, then fix the adapter file at RepairContext.adapter.sourcePath and retry. Max 3 repair rounds. See the opencli-autofix skill for the full workflow.
Related Skills
- opencli-browser — Browser automation for AI agents (navigate, click, type, extract via Chrome)
- opencli-explorer — Full guide for creating new adapters (API discovery, auth strategy, TS writing)
- opencli-oneshot — Quick 4-step template for adding a single command from a URL
- opencli-autofix — Automatically fix broken adapters when commands fail
1---2name: qiaomu-opencli-usage-23description: Use when running OpenCLI commands to interact with websites (Bilibili, Twitter, Reddit, Xiaohongshu, etc.), desktop apps (Cursor, Notion), or public APIs (HackerNews, arXiv). Covers installation, command reference, and output formats for 79+ adapters.4---56# OpenCLI Usage Guide78> Make any website or Electron App your CLI. Reuse Chrome login, zero risk, AI-powered discovery.910## Install & Run1112```bash13# npm global install (recommended)14npm install -g @jackwener/opencli15opencli <command>1617# Or from source18cd ~/code/opencli && npm install19npx tsx src/main.ts <command>2021# Update to latest22npm update -g @jackwener/opencli23```2425## Prerequisites2627Browser commands require:281. Chrome browser running **(logged into target sites)**292. **opencli Browser Bridge** Chrome extension installed (load `extension/` as unpacked in `chrome://extensions`)303. No further setup needed — the daemon auto-starts on first browser command3132> **Note**: You must be logged into the target website in Chrome before running commands. Tabs opened during command execution are auto-closed afterwards.3334Public API commands (`hackernews`, `v2ex`) need no browser.3536## Quick Lookup by Capability3738| Capability | Platforms (partial list) |39|-----------|--------------------------|40| **search** | Bilibili, Twitter, Reddit, Xiaohongshu, Zhihu, YouTube, Google, arXiv, LinkedIn, Pixiv, etc. |41| **hot/trending** | Bilibili, Twitter, Weibo, HackerNews, Reddit, V2EX, Xueqiu, Lobsters, Douban |42| **feed/timeline** | Twitter, Reddit, Xiaohongshu, Xueqiu, Jike, Facebook, Instagram, Medium |43| **user/profile** | Twitter, Reddit, Instagram, TikTok, Facebook, Bilibili, Pixiv |44| **post/create** | Twitter, Jike, Douyin, Weibo |45| **AI chat** | Grok, Doubao, ChatGPT, Gemini, Cursor, Codex, NotebookLM |46| **finance/stock** | Xueqiu, Yahoo Finance, Barchart, Sina Finance, Bloomberg |47| **web scraping** | `opencli web read --url <url>` — any URL to Markdown |48| **GitHub/DevOps** | `opencli gh`, `opencli docker`, `opencli vercel` — external CLI passthrough |49| **collaboration** | `opencli lark-cli`, `opencli dws`, `opencli wecom-cli` — external CLI passthrough |5051## Command Quick Reference5253Usage: `opencli <site> <command> [args] [--limit N] [-f json|yaml|md|csv|table]`5455Type legend: 🌐 = Browser (needs Chrome login) · ✅ = Public API (no browser) · 🖥️ = Desktop (Electron/CDP) · 🔧 = External CLI (passthrough)5657### Website Adapters5859| Site | Type | Commands |60|------|------|----------|61| **1688** | 🌐 | `search` `item` `download` `store` |62| **36kr** | 🌐 | `hot` `news` `search` `article` |63| **amazon** | 🌐 | `bestsellers` `search` `product` `offer` `discussion` `movers-shakers` `new-releases` |64| **apple-podcasts** | ✅ | `top` `search` `episodes` |65| **arxiv** | ✅ | `search` `paper` |66| **band** | 🌐 | `bands` `posts` `post` `mentions` |67| **barchart** | 🌐 | `quote` `options` `greeks` `flow` |68| **bbc** | ✅ | `news` |69| **bilibili** | 🌐 | `hot` `search` `me` `favorite` `history` `feed` `user-videos` `subtitle` `dynamic` `ranking` `following` |70| **bloomberg** | ✅🌐 | RSS: `main` `markets` `tech` `politics` `economics` `opinions` `industries` `businessweek` `feeds` · Browser: `news` (full article) |71| **bluesky** | 🌐 | `search` `profile` `user` `feeds` `followers` `following` `thread` `trending` `starter-packs` |72| **boss** | 🌐 | `search` `detail` `recommend` `joblist` `greet` `batchgreet` `send` `chatlist` `chatmsg` `invite` `mark` `exchange` `resume` `stats` |73| **chaoxing** | 🌐 | `assignments` `exams` |74| **coupang** | 🌐 | `search` `add-to-cart` |75| **ctrip** | 🌐 | `search` |76| **devto** | ✅ | `top` `tag` `user` |77| **dictionary** | ✅ | `search` `synonyms` `examples` |78| **doubao** | 🌐 | `status` `new` `send` `read` `ask` `detail` `history` `meeting-summary` `meeting-transcript` |79| **douban** | 🌐 | `search` `top250` `subject` `photos` `download` `marks` `reviews` `movie-hot` `book-hot` |80| **douyin** | 🌐 | `profile` `videos` `user-videos` `activities` `collections` `hashtag` `location` `stats` `publish` `draft` `drafts` `delete` `update` |81| **facebook** | 🌐 | `feed` `profile` `search` `friends` `groups` `events` `notifications` `memories` `add-friend` `join-group` |82| **gemini** | 🌐 | `ask` `new` `image` `deep-research` `deep-research-result` |83| **google** | ✅ | `news` `search` `suggest` `trends` |84| **grok** | 🌐 | `ask` |85| **hackernews** | ✅ | `top` `new` `best` `ask` `show` `jobs` `search` `user` |86| **hf** | ✅ | `top` |87| **hupu** | 🌐 | `hot` `search` `detail` `like` `unlike` `reply` `mentions` |88| **imdb** | ✅ | `top` `trending` `search` `title` `person` `reviews` |89| **instagram** | 🌐 | `explore` `profile` `search` `user` `followers` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `saved` |90| **jd** | 🌐 | `item` |91| **jianyu** | 🌐 | `search` |92| **jike** | 🌐 | `feed` `search` `create` `like` `comment` `repost` `notifications` `post` `topic` `user` |93| **jimeng** | 🌐 | `generate` `history` |94| **lesswrong** | ✅ | `frontpage` `curated` `new` `top` `top-week` `top-month` `top-year` `shortform` `read` `comments` `user` `user-posts` `sequences` `tags` `tag` |95| **linkedin** | 🌐 | `search` `timeline` |96| **linux-do** | 🌐 | `hot` `latest` `feed` `search` `categories` `category` `tags` `topic` `topic-content` `user-posts` `user-topics` |97| **lobsters** | ✅ | `hot` `newest` `active` `tag` |98| **medium** | 🌐 | `feed` `search` `user` |99| **notebooklm** | 🌐 | `status` `list` `open` `current` `get` `history` `summary` `note-list` `notes-get` `source-list` `source-get` `source-fulltext` `source-guide` |100| **ones** | 🌐 | `login` `logout` `me` `tasks` `task` `my-tasks` `worklog` `token-info` |101| **paperreview** | ✅ | `submit` `review` `feedback` |102| **pixiv** | 🌐 | `ranking` `search` `user` `illusts` `detail` `download` |103| **producthunt** | ✅ | `today` `hot` `browse` `posts` |104| **quark** | 🌐 | `ls` `mkdir` `mv` `rename` `rm` `save` `share-tree` |105| **reddit** | 🌐 | `hot` `frontpage` `popular` `search` `subreddit` `read` `user` `user-posts` `user-comments` `upvote` `save` `comment` `subscribe` `saved` `upvoted` |106| **reuters** | 🌐 | `search` |107| **sinablog** | 🌐 | `hot` `search` `article` `user` |108| **sinafinance** | ✅ | `news` |109| **smzdm** | 🌐 | `search` |110| **spotify** | ✅ | `auth` `status` `play` `pause` `next` `prev` `volume` `search` `queue` `shuffle` `repeat` |111| **stackoverflow** | ✅ | `hot` `search` `bounties` `unanswered` |112| **steam** | ✅ | `top-sellers` |113| **substack** | 🌐 | `feed` `search` `publication` |114| **tieba** | 🌐 | `hot` `search` `posts` `read` |115| **tiktok** | 🌐 | `explore` `search` `profile` `user` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `live` `notifications` `friends` |116| **twitter** | 🌐 | `trending` `bookmarks` `search` `profile` `timeline` `thread` `article` `follow` `unfollow` `bookmark` `unbookmark` `post` `like` `likes` `reply` `delete` `block` `unblock` `followers` `following` `notifications` `hide-reply` `download` `accept` `reply-dm` |117| **v2ex** | ✅🌐 | Public: `hot` `latest` `topic` `node` `nodes` `member` `user` `replies` · Browser: `daily` `me` `notifications` |118| **web** | 🌐 | `read` — any URL to Markdown |119| **weibo** | 🌐 | `hot` `search` `feed` `user` `me` `post` `comments` |120| **weixin** | 🌐 | `download` — 公众号 article to Markdown |121| **weread** | 🌐 | `shelf` `search` `book` `highlights` `notes` `notebooks` `ranking` |122| **wikipedia** | ✅ | `search` `summary` `random` `trending` |123| **xianyu** | 🌐 | `search` `item` `chat` |124| **xiaoe** | 🌐 | `courses` `catalog` `content` `detail` `play-url` |125| **xiaohongshu** | 🌐 | `search` `notifications` `feed` `user` `note` `comments` `download` `publish` `creator-notes` `creator-note-detail` `creator-notes-summary` `creator-profile` `creator-stats` |126| **xiaoyuzhou** | ✅ | `podcast` `podcast-episodes` `episode` |127| **xueqiu** | 🌐 | `hot-stock` `stock` `watchlist` `feed` `hot` `search` `comments` `earnings-date` `fund-holdings` `fund-snapshot` |128| **yahoo-finance** | 🌐 | `quote` |129| **yollomi** | 🌐 | `models` `generate` `video` `upload` `remove-bg` `edit` `background` `face-swap` `object-remover` `restore` `try-on` `upscale` |130| **youtube** | 🌐 | `search` `video` `transcript` |131| **yuanbao** | 🌐 | `new` `ask` |132| **zhihu** | 🌐 | `hot` `search` `question` |133| **zsxq** | 🌐 | `groups` `dynamics` `topics` `topic` `search` |134135### Desktop Apps (CDP/Electron)136137| App | Commands |138|-----|----------|139| **antigravity** | `status` `send` `read` `new` `dump` `extract-code` `model` `watch` |140| **chatgpt** | `status` `new` `send` `read` `ask` `model` |141| **chatwise** | `status` `new` `send` `read` `ask` `model` `history` `export` `screenshot` |142| **codex** | `status` `send` `read` `new` `dump` `extract-diff` `model` `ask` `screenshot` `history` `export` |143| **cursor** | `status` `send` `read` `new` `dump` `composer` `model` `extract-code` `ask` `screenshot` `history` `export` |144| **discord-app** | `status` `send` `read` `channels` `servers` `search` `members` |145| **doubao-app** | `status` `new` `send` `read` `ask` `screenshot` `dump` |146| **notion** | `status` `search` `read` `new` `write` `sidebar` `favorites` `export` |147148### External CLI (passthrough)149150OpenCLI can discover, auto-install, and passthrough commands to external CLI tools. Use `opencli install <name>` to auto-install, or `opencli register <name>` to register a local CLI.151152| CLI | Description | Commands |153|-----|-------------|----------|154| **gh** | GitHub CLI — repos, PRs, issues, releases | `repo` `pr` `issue` (all gh subcommands) |155| **obsidian** | Obsidian vault — notes, search, tags | All obsidian subcommands |156| **docker** | Docker CLI | All docker subcommands |157| **lark-cli** | Lark/Feishu — messages, docs, calendar, tasks (200+ commands) | All lark-cli subcommands |158| **dws** | DingTalk Workspace — messages, docs, calendar, contacts | All dws subcommands |159| **wecom-cli** | WeCom/企业微信 — contacts, todos, meetings, messages | All wecom-cli subcommands |160| **vercel** | Vercel — deploy, domains, env vars, logs | All vercel subcommands |161162```bash163opencli install gh # Auto-install gh CLI164opencli register my-tool # Register a local custom CLI165opencli gh pr list --limit 5 # Passthrough to gh166opencli docker ps # Passthrough to docker167opencli lark-cli msg send ... # Passthrough to lark-cli168```169170### Management171172```bash173opencli list [-f json|yaml] # List all commands174opencli validate [site] # Validate adapter definitions175opencli doctor # Diagnose browser bridge176opencli explore <url> # AI-powered API discovery177opencli record <url> # Record API calls manually178```179180All commands support: `--format` / `-f` with `table` `json` `yaml` `md` `csv`181182## Self-Repair183184If a command fails due to a site change (selector, API, or response schema), **automatically fix the adapter and retry** instead of reporting failure. Re-run the command with `OPENCLI_DIAGNOSTIC=1` to get structured diagnostic context, then fix the adapter file at `RepairContext.adapter.sourcePath` and retry. Max 3 repair rounds. See the `opencli-autofix` skill for the full workflow.185186## Related Skills187188- **opencli-browser** — Browser automation for AI agents (navigate, click, type, extract via Chrome)189- **opencli-explorer** — Full guide for creating new adapters (API discovery, auth strategy, TS writing)190- **opencli-oneshot** — Quick 4-step template for adding a single command from a URL191- **opencli-autofix** — Automatically fix broken adapters when commands fail
joeseesun