OpenCLI Usage Guide
Make any website or Electron App your CLI. Reuse Chrome login, zero risk, AI-powered discovery.
Install & Run
bash# 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 inchrome://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 |
| 🌐 | feed profile search friends groups events notifications memories add-friend join-group | |
| gemini | 🌐 | ask new image deep-research deep-research-result |
| ✅ | 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 |
| 🌐 | 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 |
| 🌐 | 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 |
| 🌐 | 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 |
| 🌐 | 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 |
| 🌐 | 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 |
bashopencli 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
bashopencli 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
