jackwener/OpenCLIPublic

Make Any Website into CLI & Use your logged-in browser by AI agent.

AI summary: Runtime converting any website or tool into a deterministic CLI allowing agents to operate logged-in browser sessions.

Stars
31.2K
+87 today
Forks
3K
Watchers
62
Open issues
106
Open PRs
227
Contributors
~268
Commits
1.7K
Branches
385
Views (30d)
2

JavaScriptApache-2.0Created Mar 14, 2026Last push 13d agoLatest release v2.0.3+150 stars this week+712 this month

Quick answers

What is OpenCLI?
Runtime converting any website or tool into a deterministic CLI allowing agents to operate logged-in browser sessions.
What does OpenCLI do?
OpenCLI functions as a unified automation hub that turns complex web interfaces and local applications into standardized command-line tools. It provides built-in adapters for popular platforms, allowing users to interact with sites like Twitter, Reddit, or HackerNews directly from the terminal. More significantly, it enables AI agents to utilize the 'opencli-browser' skill to navigate, extract data, and perform actions within a user's authenticated Chrome session. By bridging the gap between web GUIs and terminal commands, it allows developers to build robust automation workflows that seamlessly integrate web interactions with local system operations.
Who is OpenCLI for?
Power users, automation engineers, and developers building agentic workflows who want to programmatically interact with web applications. It requires familiarity with CLI environments and AI agent concepts.
How do I get started with OpenCLI?
npm install -g opencli
How popular is OpenCLI on GitHub?
jackwener/OpenCLI has 31,175 stars and 3,047 forks on GitHub, and gained 150 stars in the last 7 days.
What license does OpenCLI use?
jackwener/OpenCLI is released under the Apache-2.0 license.

Star history

since Jul 30, 2026
010K20K30KJul 2026Sep 2026Oct 2026Nov 2026
31.2K stars as of Nov 19, 2026. Measured daily since Jul 30, 2026; GitHub no longer exposes earlier star timestamps.

Update history

3 recorded
  • Nov 19, 2026New release v2.0.3 (previously v2.0.2).
  • Oct 23, 2026New release v2.0.2 (previously v1.8.8).
  • Oct 4, 2026Previously tracked as jackwener/opencli; its 3 daily snapshots and 0 trending appearances were merged into this profile. Stars: 27,596 on 2026-08-02 under the old name, 29,771 on 2026-10-02 (+2,175).

Contribution activity

commits per day, last 52 weeks
NovDecJanFebMarAprMayJunJulAugSepOctNovMonWedFri2025-11-23: 0 commits2025-11-24: 0 commits2025-11-25: 0 commits2025-11-26: 0 commits2025-11-27: 0 commits2025-11-28: 0 commits2025-11-29: 0 commits2025-11-30: 0 commits2025-12-01: 0 commits2025-12-02: 0 commits2025-12-03: 0 commits2025-12-04: 0 commits2025-12-05: 0 commits2025-12-06: 0 commits2025-12-07: 0 commits2025-12-08: 0 commits2025-12-09: 0 commits2025-12-10: 0 commits2025-12-11: 0 commits2025-12-12: 0 commits2025-12-13: 0 commits2025-12-14: 0 commits2025-12-15: 0 commits2025-12-16: 0 commits2025-12-17: 0 commits2025-12-18: 0 commits2025-12-19: 0 commits2025-12-20: 0 commits2025-12-21: 0 commits2025-12-22: 0 commits2025-12-23: 0 commits2025-12-24: 0 commits2025-12-25: 0 commits2025-12-26: 0 commits2025-12-27: 0 commits2025-12-28: 0 commits2025-12-29: 0 commits2025-12-30: 0 commits2025-12-31: 0 commits2026-01-01: 0 commits2026-01-02: 0 commits2026-01-03: 0 commits2026-01-04: 0 commits2026-01-05: 0 commits2026-01-06: 0 commits2026-01-07: 0 commits2026-01-08: 0 commits2026-01-09: 0 commits2026-01-10: 0 commits2026-01-11: 0 commits2026-01-12: 0 commits2026-01-13: 0 commits2026-01-14: 0 commits2026-01-15: 0 commits2026-01-16: 0 commits2026-01-17: 0 commits2026-01-18: 0 commits2026-01-19: 0 commits2026-01-20: 0 commits2026-01-21: 0 commits2026-01-22: 0 commits2026-01-23: 0 commits2026-01-24: 0 commits2026-01-25: 0 commits2026-01-26: 0 commits2026-01-27: 0 commits2026-01-28: 0 commits2026-01-29: 0 commits2026-01-30: 0 commits2026-01-31: 0 commits2026-02-01: 0 commits2026-02-02: 0 commits2026-02-03: 0 commits2026-02-04: 0 commits2026-02-05: 0 commits2026-02-06: 0 commits2026-02-07: 0 commits2026-02-08: 0 commits2026-02-09: 0 commits2026-02-10: 0 commits2026-02-11: 0 commits2026-02-12: 0 commits2026-02-13: 0 commits2026-02-14: 0 commits2026-02-15: 0 commits2026-02-16: 0 commits2026-02-17: 0 commits2026-02-18: 0 commits2026-02-19: 0 commits2026-02-20: 0 commits2026-02-21: 0 commits2026-02-22: 0 commits2026-02-23: 0 commits2026-02-24: 0 commits2026-02-25: 0 commits2026-02-26: 0 commits2026-02-27: 0 commits2026-02-28: 0 commits2026-03-01: 0 commits2026-03-02: 0 commits2026-03-03: 0 commits2026-03-04: 0 commits2026-03-05: 0 commits2026-03-06: 0 commits2026-03-07: 0 commits2026-03-08: 0 commits2026-03-09: 0 commits2026-03-10: 0 commits2026-03-11: 0 commits2026-03-12: 0 commits2026-03-13: 0 commits2026-03-14: 0 commits2026-03-15: 82 commits2026-03-16: 43 commits2026-03-17: 35 commits2026-03-18: 45 commits2026-03-19: 34 commits2026-03-20: 64 commits2026-03-21: 26 commits2026-03-22: 43 commits2026-03-23: 25 commits2026-03-24: 57 commits2026-03-25: 33 commits2026-03-26: 20 commits2026-03-27: 23 commits2026-03-28: 31 commits2026-03-29: 13 commits2026-03-30: 11 commits2026-03-31: 14 commits2026-04-01: 9 commits2026-04-02: 20 commits2026-04-03: 27 commits2026-04-04: 27 commits2026-04-05: 27 commits2026-04-06: 9 commits2026-04-07: 10 commits2026-04-08: 21 commits2026-04-09: 22 commits2026-04-10: 13 commits2026-04-11: 23 commits2026-04-12: 5 commits2026-04-13: 15 commits2026-04-14: 17 commits2026-04-15: 9 commits2026-04-16: 5 commits2026-04-17: 6 commits2026-04-18: 0 commits2026-04-19: 7 commits2026-04-20: 7 commits2026-04-21: 23 commits2026-04-22: 10 commits2026-04-23: 6 commits2026-04-24: 2 commits2026-04-25: 2 commits2026-04-26: 1 commit2026-04-27: 11 commits2026-04-28: 5 commits2026-04-29: 2 commits2026-04-30: 1 commit2026-05-01: 5 commits2026-05-02: 11 commits2026-05-03: 24 commits2026-05-04: 26 commits2026-05-05: 16 commits2026-05-06: 25 commits2026-05-07: 24 commits2026-05-08: 13 commits2026-05-09: 1 commit2026-05-10: 16 commits2026-05-11: 19 commits2026-05-12: 16 commits2026-05-13: 18 commits2026-05-14: 21 commits2026-05-15: 8 commits2026-05-16: 8 commits2026-05-17: 0 commits2026-05-18: 15 commits2026-05-19: 27 commits2026-05-20: 14 commits2026-05-21: 7 commits2026-05-22: 4 commits2026-05-23: 2 commits2026-05-24: 0 commits2026-05-25: 3 commits2026-05-26: 3 commits2026-05-27: 3 commits2026-05-28: 2 commits2026-05-29: 0 commits2026-05-30: 0 commits2026-05-31: 9 commits2026-06-01: 24 commits2026-06-02: 9 commits2026-06-03: 1 commit2026-06-04: 3 commits2026-06-05: 6 commits2026-06-06: 10 commits2026-06-07: 0 commits2026-06-08: 0 commits2026-06-09: 0 commits2026-06-10: 0 commits2026-06-11: 2 commits2026-06-12: 9 commits2026-06-13: 0 commits2026-06-14: 4 commits2026-06-15: 7 commits2026-06-16: 1 commit2026-06-17: 6 commits2026-06-18: 1 commit2026-06-19: 2 commits2026-06-20: 1 commit2026-06-21: 5 commits2026-06-22: 6 commits2026-06-23: 1 commit2026-06-24: 3 commits2026-06-25: 0 commits2026-06-26: 0 commits2026-06-27: 5 commits2026-06-28: 5 commits2026-06-29: 0 commits2026-06-30: 0 commits2026-07-01: 12 commits2026-07-02: 0 commits2026-07-03: 7 commits2026-07-04: 8 commits2026-07-05: 0 commits2026-07-06: 0 commits2026-07-07: 0 commits2026-07-08: 0 commits2026-07-09: 0 commits2026-07-10: 0 commits2026-07-11: 0 commits2026-07-12: 11 commits2026-07-13: 2 commits2026-07-14: 0 commits2026-07-15: 0 commits2026-07-16: 0 commits2026-07-17: 0 commits2026-07-18: 0 commits2026-07-19: 8 commits2026-07-20: 1 commit2026-07-21: 2 commits2026-07-22: 0 commits2026-07-23: 0 commits2026-07-24: 0 commits2026-07-25: 0 commits2026-07-26: 0 commits2026-07-27: 0 commits2026-07-28: 0 commits2026-07-29: 13 commits2026-07-30: 7 commits2026-07-31: 0 commits2026-08-01: 0 commits2026-08-02: 0 commits2026-08-03: 0 commits2026-08-04: 0 commits2026-08-05: 0 commits2026-08-06: 0 commits2026-08-07: 0 commits2026-08-08: 13 commits2026-08-09: 3 commits2026-08-10: 0 commits2026-08-11: 0 commits2026-08-12: 0 commits2026-08-13: 0 commits2026-08-14: 0 commits2026-08-15: 0 commits2026-08-16: 0 commits2026-08-17: 1 commit2026-08-18: 0 commits2026-08-19: 0 commits2026-08-20: 0 commits2026-08-21: 0 commits2026-08-22: 0 commits2026-08-23: 51 commits2026-08-24: 26 commits2026-08-25: 6 commits2026-08-26: 3 commits2026-08-27: 0 commits2026-08-28: 4 commits2026-08-29: 6 commits2026-08-30: 0 commits2026-08-31: 1 commit2026-09-01: 0 commits2026-09-02: 0 commits2026-09-03: 0 commits2026-09-04: 0 commits2026-09-05: 0 commits2026-09-06: 0 commits2026-09-07: 0 commits2026-09-08: 0 commits2026-09-09: 0 commits2026-09-10: 0 commits2026-09-11: 0 commits2026-09-12: 0 commits2026-09-13: 0 commits2026-09-14: 0 commits2026-09-15: 0 commits2026-09-16: 0 commits2026-09-17: 0 commits2026-09-18: 0 commits2026-09-19: 0 commits2026-09-20: 0 commits2026-09-21: 0 commits2026-09-22: 0 commits2026-09-23: 0 commits2026-09-24: 0 commits2026-09-25: 1 commit2026-09-26: 0 commits2026-09-27: 0 commits2026-09-28: 0 commits2026-09-29: 0 commits2026-09-30: 0 commits2026-10-01: 0 commits2026-10-02: 0 commits2026-10-03: 0 commits2026-10-04: 0 commits2026-10-05: 0 commits2026-10-06: 0 commits2026-10-07: 0 commits2026-10-08: 0 commits2026-10-09: 0 commits2026-10-10: 2 commits2026-10-11: 0 commits2026-10-12: 3 commits2026-10-13: 6 commits2026-10-14: 0 commits2026-10-15: 0 commits2026-10-16: 25 commits2026-10-17: 18 commits2026-10-18: 0 commits2026-10-19: 0 commits2026-10-20: 3 commits2026-10-21: 1 commit2026-10-22: 0 commits2026-10-23: 1 commit2026-10-24: 0 commits2026-10-25: 1 commit2026-10-26: 8 commits2026-10-27: 0 commits2026-10-28: 0 commits2026-10-29: 0 commits2026-10-30: 0 commits2026-10-31: 0 commits2026-11-01: 0 commits2026-11-02: 0 commits2026-11-03: 0 commits2026-11-04: 0 commits2026-11-05: 12 commits2026-11-06: 14 commits2026-11-07: 0 commits2026-11-08: 1 commit2026-11-09: 0 commits2026-11-10: 0 commits2026-11-11: 0 commits2026-11-12: 0 commits2026-11-13: 0 commits2026-11-14: 0 commits2026-11-15: 0 commits2026-11-16: 0 commits2026-11-17: 0 commits2026-11-18: 0 commits2026-11-19: 0 commits2026-11-20: 0 commits2026-11-21: 0 commits
1,673 commits in the last yearLessMore

Signals and awards

derived from tracked data
  • Widely adopted

    31,175 stars

  • Community-driven

    ~268 contributors

  • Permissive license

    Apache-2.0

  • Continuous integration

    Automated checks passing

What OpenCLI does

OpenCLI functions as a unified automation hub that turns complex web interfaces and local applications into standardized command-line tools. It provides built-in adapters for popular platforms, allowing users to interact with sites like Twitter, Reddit, or HackerNews directly from the terminal. More significantly, it enables AI agents to utilize the 'opencli-browser' skill to navigate, extract data, and perform actions within a user's authenticated Chrome session. By bridging the gap between web GUIs and terminal commands, it allows developers to build robust automation workflows that seamlessly integrate web interactions with local system operations.

Power users, automation engineers, and developers building agentic workflows who want to programmatically interact with web applications. It requires familiarity with CLI environments and AI agent concepts.

  • Web-to-CLI Adapters: Converts complex website functionalities into simple, deterministic terminal commands.
  • Agentic Browser Control: Allows AI coding agents to navigate and interact with web pages using a user's logged-in session.
  • Local Tool Hub: Centralizes access to local binaries and desktop applications (like Docker or Electron apps) under one interface.
  • Custom Adapter Authoring: Provides tools and agent skills to quickly build new CLI adapters for unsupported websites.
  • System Tray Integration: Includes a desktop app component to manage browser keep-alives and runtime diagnostics.

Where teams use it

Authenticated Web Scraping

Extract data from platforms that require complex logins by using the user's active browser session.

Agentic Workflow Automation

Allow an AI agent to read a local bug report, open a browser, navigate to a tracking system, and submit a ticket.

Terminal-Based Web Browsing

Read articles, check social media feeds, or manage cloud infrastructure without leaving the command line.

Unified Tool Management

Standardize access to disparate local developer tools and web services through a single command interface.

Getting started: npm install -g opencli

README

main branch

OpenCLI

Convert any website into a CLI & run Browser Use on your logged-in Chrome. Turn websites and browser sessions into deterministic interfaces for humans and AI agents. Or run Browser Use against any page — navigate, fill forms, click, extract, automate.

中文文档 npm Chrome Web Store Node.js Version License

OpenCLI is a general-purpose browser automation CLI for AI agents and an agent-browser alternative. Navigate, inspect, click, fill forms, extract, and screenshot websites without a site adapter. Built-in adapters add reusable, deterministic site commands. See OpenCLI vs agent-browser and migration.

OpenCLI gives you one surface for three different kinds of automation:

  • Use built-in adapters for sites like Bilibili, Zhihu, Xiaohongshu, Reddit, HackerNews, Twitter/X, and many more.
  • Let AI Agents operate any website — install the opencli-browser skill in your AI agent (Claude Code, Cursor, etc.), and it can navigate, click, type/fill, extract, and inspect any page through your logged-in browser via opencli browser primitives.
  • Write new adapters end-to-end with opencli browser + the opencli-adapter-author skill, which guides from first recon through field decoding, code, and opencli adapter test.

Agent command contract

Commands default to JSON: { "ok": true, "data": ... }; failures return { "ok": false, "error": { "code": "...", "message": "...", "hint": "..." } } on stdout with a nonzero exit code. Logs use stderr. Explicit human formats, help, version and completion retain their own formats; browser follow modes use JSON Lines.

opencli list search --site github
opencli browser open https://example.com --session research
opencli browser network --static --session research
opencli browser chrome describe
opencli adapter check github/search

list returns compact, paginated capabilities (commands, total, nextOffset); read arguments with <command> --help -f json. Page scope is --session, native Chrome calls need no session. Adapter authoring is grouped under adapter init|check|test. state --diagnostics and network --static replace analyze and discover. This changes CLI syntax and JSON output. JS adapters keep cli({...}), func(args) and func(page, args); adapter defaultFormat no longer changes the CLI default.

Quick Start

1. Install OpenCLI

For desktop use, start with OpenCLIApp. It bundles the OpenCLI runtime, keeps the managed opencli command installed, and gives you a system tray UI for setup, diagnostics, updates, browser-login keepalive, and Web → Markdown.

Option A — OpenCLIApp (recommended for macOS / Windows): Download the latest app from https://opencli.info/download, install it, then open the app once and use the System page to install or repair the opencli command.

Option B — npm global install (CLI-only / CI / servers): OpenCLI requires Node.js >= 20.18.1 when installed through npm.

node --version
npm install -g @jackwener/opencli

2. Install the Browser Bridge Extension

OpenCLI connects to Chrome/Chromium through a lightweight Browser Bridge extension plus a small local daemon. The daemon auto-starts when needed.

Option A — Chrome Web Store (recommended): Install OpenCLI from the Chrome Web Store.

Option B — Manual install:

  1. Download the latest opencli-extension-v{version}.zip from the GitHub Releases page.
  2. Unzip it, open chrome://extensions, and enable Developer mode.
  3. Click Load unpacked and select the unzipped folder.

3. Verify the setup

opencli doctor

4. Optional: name your Chrome profile

Each Chrome profile runs its own OpenCLI extension instance. If you use multiple Chrome profiles, list the connected profiles and assign local aliases:

opencli profile list
opencli profile rename <contextId> work
opencli profile use work
opencli --profile work browser main state

With only one connected profile, OpenCLI uses it automatically. With multiple connected profiles and no default, OpenCLI asks you to choose instead of guessing.

5. Run your first commands

opencli list
opencli hackernews top --limit 5
opencli bilibili hot --limit 5

For Humans

Use OpenCLI directly when you want a reliable command instead of a live browser session:

  • opencli list shows every registered command.
  • opencli <site> <command> runs a built-in or generated adapter.
  • opencli doctor helps diagnose browser connectivity.

Extending OpenCLI

If you want to add your own commands, start with the Extending OpenCLI guide. README keeps this short; the guide covers the directory layout, source-control model, and install commands.

Need Recommended path
Keep personal website commands in your own Git repo opencli plugin create + opencli plugin install file://...
Quickly draft a private local adapter opencli adapter init <site>/<command> in ~/.opencli/clis/
Modify an official adapter locally opencli adapter eject <site> + opencli adapter reset <site>
Publish or install third-party commands opencli plugin install github:user/repo

Close temporary browser tabs after use

To remove temporary owned tabs when a workflow finishes:

export OPENCLI_CLOSE_OWNED_TAB=1
opencli web read --url https://example.com --stdout true
# Multi-step browser sessions stay open between calls; close explicitly at the end:
opencli browser close --session research

This opts into closing only the current lease's owned tab. Chrome closes its window automatically if no tabs remain; existing user pages and other sessions are preserved. Bound tabs are detached and kept open. The default reusable container policy, idle expiry, --keep-tab true, and persistent site sessions remain unchanged. Use --site-session ephemeral for one-shot reads of adapters that otherwise keep a persistent site session.

Cleanup uses a dedicated action, so older extensions reject it without releasing the lease, and requires an extension acknowledgement. If cleanup fails or the extension is too old, a warning reports it separately from the site action. Retry explicit browser cleanup, or close a remaining one-shot adapter tab manually; do not repeat a completed site write. Explicit browser close also exits with an error; a one-shot adapter can still return its already-completed result.

For AI Agents

OpenCLI's browser commands are designed to be used by AI Agents — not run manually. Install skills into your AI agent (Claude Code, Cursor, etc.), and the agent operates websites on your behalf using your logged-in Chrome session.

Install skills (also refreshes existing installs)

npx skills add jackwener/opencli

Or install only what you need:

npx skills add jackwener/opencli --skill opencli-adapter-author
npx skills add jackwener/opencli --skill opencli-autofix
npx skills add jackwener/opencli --skill opencli-browser
npx skills add jackwener/opencli --skill opencli-usage

OpenCLI no longer ships the sitemap skills. Older opencli-sitemap-author and opencli-browser-sitemap copies may remain in an agent's separate skills directory after an upgrade. If they remain, use the agent's removal flow if available; otherwise remove only those two directories (for example, ~/.agents/skills/opencli-sitemap-author). The location varies by agent; keep the rest of the skills directory.

Which skill to use

Skill When to use Example prompt to your AI agent
opencli-adapter-author Write a reusable adapter for a new site or add a command to an existing site "Write an adapter for douyin trending" / "Make a command that grabs the top posts from this page"
opencli-autofix Repair a broken adapter when a built-in command fails "opencli zhihu hot is returning empty — fix it"
opencli-browser Drive a real Chrome page ad-hoc — navigate, fill forms, click, extract "Help me check my Xiaohongshu notifications" / "Help me fill out this form" / "Use browser commands to scrape this page"
opencli-usage Quick reference for all OpenCLI commands and sites "What commands does OpenCLI have for Twitter?"

How it works

Once opencli-browser is installed, your AI agent can:

  1. Navigate to any URL using your logged-in browser
  2. Read page content via structured DOM snapshots (not screenshots)
  3. Interact — click buttons, fill forms, select options, press keys
  4. Extract data from the page or intercept network API responses
  5. Wait for elements, text, or page transitions

The agent handles all the opencli browser commands internally — you just describe what you want done in natural language.

Skill references:

Available browser commands include open, state, click, type, fill, select, keys, wait, get, find, extract, frames, screenshot, scroll, back, eval, network, tab list, tab new, tab select, tab close, chrome describe, chrome call, and close.

opencli browser commands require a --session <name> option for page operations. opencli browser --session work open <url> and opencli browser --session work tab new [url] both return a target ID. Use opencli browser --session work tab list to inspect target IDs, then pass --tab <targetId> to route a command to a specific tab. tab new creates a new tab without changing the default browser target; only tab select <targetId> promotes that tab to the default target for later untargeted commands in the same session.

Writing a new adapter

When the site you need is not yet covered, use the opencli-adapter-author skill end-to-end:

  1. Recon the site and pick a pattern (SPA / SSR / JSONP / Token / Streaming).
  2. Discover the right endpoint — network inspection, initial state, bundle search, token trace, or interceptor fallback.
  3. Pick auth — PUBLIC / COOKIE / INTERCEPT / UI / LOCAL.
  4. Decode response fields and design output columns.
  5. opencli browser recon analyze <url> → opencli browser recon init <site>/<name> → write adapter → opencli browser recon verify <site>/<name>.
  6. Site knowledge persists to ~/.opencli/sites/<site>/ so the next adapter for the same site starts from context.

Configuration

Variable Default Description
OPENCLI_PROFILE — Browser Bridge profile alias/contextId to use when multiple Chrome profiles are connected
OPENCLI_WINDOW command default Set to foreground or background to override Browser Bridge window placement. Browser-backed commands also accept --window <foreground|background>.
OPENCLI_SITE_SESSION adapter default Set to ephemeral or persistent to override siteSession metadata for browser-backed adapter commands. ephemeral releases the one-shot tab when the command finishes, and the automation window stays open as a reusable container; persistent reuses the site's session. Per-command --site-session takes precedence.
OPENCLI_CLOSE_OWNED_TAB 0 Set to 1 to close the current owned tab on explicit session close or one-shot adapter cleanup instead of keeping a blank placeholder. Requires a supporting Browser Bridge extension.
OPENCLI_SITE_SLOTS — Pool sites onto warm persistent tabs, e.g. xiaohongshu:1:1500-3000,weibo:2 (site:poolSize[:minMs[-maxMs]]). Each command run borrows one slot tab exclusively (reads included) and queues when all are busy; the optional interval spaces runs by a jittered delay. Tabs share one automation window and only its active tab renders, so with poolSize > 1 render-dependent commands (lazy-loaded lists) can stall on background slots — use 1 for those and for risk-controlled sites. --site-session ephemeral opts one invocation out.
OPENCLI_BROWSER_CONNECT_TIMEOUT 45 Seconds to wait for browser connection
OPENCLI_BROWSER_COMMAND_TIMEOUT 60 Seconds to wait for a single browser command
OPENCLI_BROWSER_IDLE_TIMEOUT extension default Owned session idle timeout in seconds; per-command idleTimeout takes precedence. Does not extend explicit cleanup: ephemeral adapters normally release their tab at command completion. Bound tabs and persistent adapter sessions ignore idle timeouts. Releasing a session keeps its reusable window container open.
OPENCLI_CDP_ENDPOINT — Chrome DevTools Protocol endpoint for remote browsers
OPENCLI_CDP_TARGET — Filter CDP targets by URL substring (e.g. detail.1688.com)
OPENCLI_VERBOSE false Enable verbose logging (-v flag also works)
DEBUG_SNAPSHOT — Set to 1 for DOM snapshot debug output

opencli browser * requires an explicit --session <name> option for page operations, uses a foreground browser window by default, and keeps that session's tab lease until opencli browser --session <session> close or idle cleanup. Browser-backed adapters use a background adapter window and release one-shot tab leases by default. Interactive adapters can declare siteSession: 'persistent' to keep a stable site tab for continuity; pass --site-session ephemeral for a one-shot tab.

Built-in Commands

Site Commands
xiaohongshu search ask note comments feed user download publish follow unfollow notifications creator-notes creator-notes-summary creator-note-detail creator-profile creator-stats
bilibili hot search history feed ranking download comments dynamic favorite following follow unfollow me subtitle summary video user-videos creator-stats
zhihu hot search question download follow like favorite comment answer
hackernews top new best ask show jobs search user
hltv search player-summary player-matches player-form player-map-pool player-vs-team player-teammate-impact player-duel match-map match-series team-matches team-map-pool event-matches
geogebra eval add-point add-line add-circle add-polygon triangle hexagon list info
linkedin connect inbox job-detail jobs-preferences post-analytics posts profile-experience profile-projects profile-read profile-analytics safe-send search services-read sent-invitations thread-snapshot timeline salesnav-search salesnav-inbox salesnav-message salesnav-thread
reddit hot frontpage popular search subreddit read user user-posts user-comments upvote upvoted save saved comment subscribe
twitter trending search timeline tweets lists list-tweets list-create list-delete list-add list-add-batch list-remove list-remove-batch bookmarks post download profile article like likes notifications reply reply-dm thread follow unfollow followers following block unblock bookmark unbookmark delete hide-reply accept
claude ask send new status read history detail
gemini new ask image deep-research deep-research-result
notebooklm status list open current get history summary note-list notes-get source-list source-get source-fulltext source-guide
amazon bestsellers search product offer discussion movers-shakers new-releases rankings
upwork search feed detail
slock message-send message-read message-search channel-list channel-info channel-create channel-members channel-join task-list task-create task-claim task-status task-convert task-delete thread-list thread-follow attachment-upload attachment-download bookmark-add inbox dm-list server-list server-use whoami
huodongxing events
midjourney login whoami settings quota generate describe history status action download

Curated highlights — → see all 100+ supported sites & commands (douyin / weibo / spotify / 1688 / quark / nowcoder / google-scholar / hupu / xianyu / weread / weread-official / xiaoyuzhou / Chess.com / and more).

Download Support

OpenCLI supports downloading images, videos, and articles from supported platforms.

Platform Content Types Notes
xiaohongshu Images, Videos Downloads all media from a note
rednote Images, Videos Downloads all media from a signed rednote note URL
bilibili Videos Requires yt-dlp installed
twitter Images, Videos From user media tab or single tweet
douban Images Poster / still image lists
pixiv Images Original-quality illustrations, multi-page
1688 Images, Videos Downloads page-visible product media from item pages
xiaoyuzhou Audio, Transcript Downloads episode audio and transcript JSON/text with local credentials
zhihu Column articles, answers (Markdown) Exports with optional image download
weixin Articles (Markdown) WeChat Official Account articles

For video downloads, install yt-dlp first: brew install yt-dlp

opencli xiaohongshu download "https://www.xiaohongshu.com/search_result/<id>?xsec_token=..." --output ./xhs
opencli xiaohongshu download "https://xhslink.com/..." --output ./xhs
opencli rednote download "https://www.rednote.com/search_result/<id>?xsec_token=..." --output ./rednote
opencli bilibili download BV1xxx --output ./bilibili
opencli twitter download elonmusk --limit 20 --output ./twitter
opencli 1688 download 841141931191 --output ./1688-downloads
opencli xiaoyuzhou download 69b3b675772ac2295bfc01d0 --output ./xiaoyuzhou
opencli xiaoyuzhou transcript 69dd0c98e2c8be31551f6a33 --output ./xiaoyuzhou-transcripts

opencli xiaoyuzhou download and transcript require local Xiaoyuzhou credentials in ~/.opencli/xiaoyuzhou.json.

Output Formats

All built-in commands support --format / -f with json (default), table, yaml, md, and csv.

opencli bilibili hot -f json    # Pipe to jq or LLMs
opencli bilibili hot -f csv     # Spreadsheet-friendly
opencli bilibili hot -v         # Verbose: show pipeline debug steps

Exit Codes

opencli follows Unix sysexits.h so CI / scripts can branch on failure mode: 0 success, 66 empty result, 69 Browser Bridge down, 75 timeout, 77 auth required, 78 config error, 130 Ctrl-C. Full reference: docs/guide/exit-codes.md.

Plugins

Extend OpenCLI with community-contributed adapters:

opencli plugin install github:user/opencli-plugin-my-tool
opencli plugin list
opencli plugin update --all
opencli plugin uninstall my-tool

Albato, Goofish and Taobao use local adapter-subdirectory installation; see the installation notes.

Plugin Type Description
opencli-plugin-albato JS Albato automation workflow management: scenario inspection, start/pause, failure diagnosis, and retry
opencli-plugin-amap JS AutoNavi / 高德地图 spot & route extraction, coordinate decoders (GCJ-02 & WGS-84), and SSR search
opencli-plugin-github-trending JS GitHub Trending repositories
opencli-plugin-goofish JS Goofish / 闲鱼 buyer orders, favorites, IM chat, profile, item search, and fulfillment stats
opencli-plugin-hot-digest JS Multi-platform trending aggregator
opencli-plugin-juejin JS 稀土掘金 (Juejin) hot articles
opencli-plugin-taobao JS Taobao buyer chat history, order history, bought shops, favorites, and keyword-based chat summaries
opencli-plugin-vk JS VK (VKontakte) wall, feed, and search
opencli-plugin-x-article-publisher JS Publish Markdown with local images as X long-form Articles via OpenCLI and xPoster

See Plugins Guide for creating your own plugin.

Testing

See TESTING.md for how to run and write tests.

Troubleshooting

  • "Extension not connected" — Ensure the Browser Bridge extension is installed from the Chrome Web Store and enabled in chrome://extensions.
  • "attach failed: Cannot access a chrome-extension:// URL" — Another extension may be interfering. Try disabling other extensions temporarily.
  • Empty data or 'Unauthorized' error — Your Chrome/Chromium login session may have expired. Navigate to the target site and log in again.
  • Node API errors / missing fetch / startup crash on old Node — OpenCLI requires Node.js >= 20.18.1. Run node --version, upgrade Node if needed, then retry.
  • Daemon issues — Check status: curl localhost:19825/status · View logs: curl localhost:19825/logs

Star History

Star History Chart

License

Apache-2.0

View on GitHub

Recent activity

commits and pull requests

Releases and announcements

117 total
  1. v2.0.3v2.0.3Nov 7, 202611.8K downloads

    Includes Chrome extension **1.0.27**. Update the extension for loopback connectivity, native keyboard input, and browser-window recovery fixes. ### Features - Add Pinduoduo search and Twitter list-members commands. - Include replies and retweets in Twitter search results, and suggest site login commands on authentication failures. ### Fixes - Agree on a reachable loopback address across the daemon, CLI, and extension; avoid replacing a newer daemon with an older CLI. - Aim browser clicks at the resolved element, detect sibling occlusion, send complete native keyboard events, and recover owned idle windows after restart. - Fall back to DataTransfer uploads when the file chooser does not open; safely replace stale plugin host junctions on Windows. - Preserve JavaScript pipes and quoted expressions in pipelines, append query parameters before URL fragments, and escape CSV/Markdown headers. - Isolate concurrent download temporary files, preserve article code blocks, and honor yt-dlp failure exit status. - Improve LinkedIn experience, activity, and job parsing; wait for Weixin verification and article rendering; fix Ctrip train navigation. - Improve Twitter identity, Facebook search

  2. v2.0.2v2.0.2Oct 20, 202624.8K downloads

    ## What's Changed * fix(release): verified OIDC publishing for 2.0.2 by @jackwener in https://github.com/jackwener/OpenCLI/pull/2686 **Full Changelog**: https://github.com/jackwener/OpenCLI/compare/v2.0.1...v2.0.2

  3. v2.0.1v2.0.1Oct 19, 2026592 downloads

    Includes Chrome extension **1.0.26**. Update the extension to receive the navigation fix. ### Features - Add a validated Douyin single-content detail reader (#2667). ### Fixes - Avoid duplicate browser navigations during extension tab lease creation, which can cause Chromium's `Navigation rejected.` error without `--trace` (#2487, #2679). - Reject native input on hidden pages without replaying the action (#2664). - Wait for complete Ctrip flight captures in the foreground (#2663). - Capture page-owned TikTok profile responses and the current identity (#2662). - Locate LinkedIn activity cards from post permalinks (#2661). - Bound Xiaohongshu lazy user pagination while retaining collected results (#2666). - Classify Xueqiu page failures and expose response shape (#2668). - Classify Instagram read failures and navigate target profiles (#2669). ### Upgrade ```sh npm install -g @jackwener/[email protected] ``` The navigation fix requires extension 1.0.26. Chrome Web Store publication follows its review process; the extension ZIP is also attached to this release. **Full Changelog**: https://github.com/jackwener/OpenCLI/compare/v2.0.0...v2.0.1

  4. OpenCLI 2.0.0v2.0.0Oct 17, 20261.1K downloads

    A major release focused on agent experience: a smaller CLI surface, predictable JSON results, native Chrome APIs, and evidence-driven adapter development. Includes Chrome extension **1.0.25**. ### Breaking changes and migration - Browser sessions are explicit options: use `opencli browser <command> ... --session research` instead of positional session names. - CLI results default to `{ "ok": true, "data": ... }`; failures use `{ "ok": false, "error": { "code", "message", "hint", ... } }` and a nonzero exit status. Update consumers to read `data`; follow modes emit JSON Lines. Explicit human-readable formats and raw exports remain available. - Use `opencli adapter init`, `adapter test`, and `adapter check` for adapter authoring and validation. These replace the former browser init/verify and adapter validation entry points. - Use `opencli browser network --static` for captured requests plus AST-derived endpoint evidence, and `opencli browser state --diagnostics` for page diagnostics. The separate discover/analyze workflow is removed. - Electron desktop automation, its app registry and public launcher export, site sitemap knowledge, and external CLI Hub passthrough are removed. Dir

  5. v1.8.8v1.8.8Aug 30, 202615K downloads

    ## What's Changed * fix: upgrade undici to 7.29.0, 8.9.0 (CVE-2026-13697) by @anupamme in https://github.com/jackwener/OpenCLI/pull/2326 * fix: sync package-lock with undici 7.29.0 bump by @jackwener in https://github.com/jackwener/OpenCLI/pull/2361 * docs: fix broken star history chart by @OctoBored in https://github.com/jackwener/OpenCLI/pull/2301 * fix(weixin): recover draft cover uploads by @jackwener in https://github.com/jackwener/OpenCLI/pull/2362 * feat(bilibili): add --top to fetch pinned comments by @henrycjchen in https://github.com/jackwener/OpenCLI/pull/2106 * fix(xiaohongshu): harvest search rows during scroll instead of first/last screen union by @sleepyy-dog in https://github.com/jackwener/OpenCLI/pull/2349 * refactor(sinafinance): use rolling news API by @jackwener in https://github.com/jackwener/OpenCLI/pull/2365 * chore(xiaohongshu): share evaluate unwrap helper by @jackwener in https://github.com/jackwener/OpenCLI/pull/2363 * feat(zhihu): preserve comment reply threads by @wuyak in https://github.com/jackwener/OpenCLI/pull/2306 * feat(zhihu): export answers with local images by @wuyak in https://github.com/jackwener/OpenCLI/pull/2304 * fix(xiaohongshu): recover

Code frequency

additions and deletions
+191.5K-191.5KWeek of 2026-03-15: +66,269 linesWeek of 2026-03-15: -18,052 linesWeek of 2026-03-22: +43,127 linesWeek of 2026-03-22: -11,711 linesWeek of 2026-03-29: +58,295 linesWeek of 2026-03-29: -10,607 linesWeek of 2026-04-05: +191,499 linesWeek of 2026-04-05: -170,189 linesWeek of 2026-04-12: +17,992 linesWeek of 2026-04-12: -3,340 linesWeek of 2026-04-19: +24,182 linesWeek of 2026-04-19: -12,102 linesWeek of 2026-04-26: +11,820 linesWeek of 2026-04-26: -3,616 linesWeek of 2026-05-03: +67,548 linesWeek of 2026-05-03: -8,884 linesWeek of 2026-05-10: +30,741 linesWeek of 2026-05-10: -11,187 linesWeek of 2026-05-17: +35,760 linesWeek of 2026-05-17: -3,266 linesWeek of 2026-05-24: +1,960 linesWeek of 2026-05-24: -230 linesWeek of 2026-05-31: +38,566 linesWeek of 2026-05-31: -2,880 linesWeek of 2026-06-07: +11,099 linesWeek of 2026-06-07: -1,142 linesWeek of 2026-06-14: +8,075 linesWeek of 2026-06-14: -336 linesWeek of 2026-06-21: +13,762 linesWeek of 2026-06-21: -2,638 linesWeek of 2026-06-28: +14,646 linesWeek of 2026-06-28: -3,033 linesWeek of 2026-07-05: +0 linesWeek of 2026-07-05: -0 linesWeek of 2026-07-12: +4,272 linesWeek of 2026-07-12: -335 linesWeek of 2026-07-19: +10,307 linesWeek of 2026-07-19: -390 linesWeek of 2026-07-26: +11,440 linesWeek of 2026-07-26: -425 linesWeek of 2026-08-02: +4,052 linesWeek of 2026-08-02: -377 linesWeek of 2026-08-09: +159 linesWeek of 2026-08-09: -26 linesWeek of 2026-08-16: +143 linesWeek of 2026-08-16: -24 linesWeek of 2026-08-23: +23,396 linesWeek of 2026-08-23: -5,488 linesWeek of 2026-08-30: +7 linesWeek of 2026-08-30: -7 linesWeek of 2026-09-06: +0 linesWeek of 2026-09-06: -0 linesWeek of 2026-09-13: +0 linesWeek of 2026-09-13: -0 linesWeek of 2026-09-20: +47 linesWeek of 2026-09-20: -4,174 linesWeek of 2026-09-27: +0 linesWeek of 2026-09-27: -0 linesWeek of 2026-10-04: +21,900 linesWeek of 2026-10-04: -42,042 linesWeek of 2026-10-11: +21,164 linesWeek of 2026-10-11: -35,624 linesWeek of 2026-10-18: +863 linesWeek of 2026-10-18: -50 linesWeek of 2026-10-25: +610 linesWeek of 2026-10-25: -66 linesWeek of 2026-11-01: +4,247 linesWeek of 2026-11-01: -1,010 linesWeek of 2026-11-08: +28 linesWeek of 2026-11-08: -7 linesWeek of 2026-11-15: +0 linesWeek of 2026-11-15: -0 linesMar 15, 2026Nov 15, 2026
+738K lines added, -353.3K removed over the last year.

Commits per week

last 52 weeks
3290Week of 2025-11-23: 0 commitsWeek of 2025-11-30: 0 commitsWeek of 2025-12-07: 0 commitsWeek of 2025-12-14: 0 commitsWeek of 2025-12-21: 0 commitsWeek of 2025-12-28: 0 commitsWeek of 2026-01-04: 0 commitsWeek of 2026-01-11: 0 commitsWeek of 2026-01-18: 0 commitsWeek of 2026-01-25: 0 commitsWeek of 2026-02-01: 0 commitsWeek of 2026-02-08: 0 commitsWeek of 2026-02-15: 0 commitsWeek of 2026-02-22: 0 commitsWeek of 2026-03-01: 0 commitsWeek of 2026-03-08: 0 commitsWeek of 2026-03-15: 329 commitsWeek of 2026-03-22: 232 commitsWeek of 2026-03-29: 121 commitsWeek of 2026-04-05: 125 commitsWeek of 2026-04-12: 57 commitsWeek of 2026-04-19: 57 commitsWeek of 2026-04-26: 36 commitsWeek of 2026-05-03: 129 commitsWeek of 2026-05-10: 106 commitsWeek of 2026-05-17: 69 commitsWeek of 2026-05-24: 11 commitsWeek of 2026-05-31: 62 commitsWeek of 2026-06-07: 11 commitsWeek of 2026-06-14: 22 commitsWeek of 2026-06-21: 20 commitsWeek of 2026-06-28: 32 commitsWeek of 2026-07-05: 0 commitsWeek of 2026-07-12: 13 commitsWeek of 2026-07-19: 11 commitsWeek of 2026-07-26: 20 commitsWeek of 2026-08-02: 13 commitsWeek of 2026-08-09: 3 commitsWeek of 2026-08-16: 1 commitsWeek of 2026-08-23: 96 commitsWeek of 2026-08-30: 1 commitsWeek of 2026-09-06: 0 commitsWeek of 2026-09-13: 0 commitsWeek of 2026-09-20: 1 commitsWeek of 2026-09-27: 0 commitsWeek of 2026-10-04: 2 commitsWeek of 2026-10-11: 52 commitsWeek of 2026-10-18: 5 commitsWeek of 2026-10-25: 9 commitsWeek of 2026-11-01: 26 commitsWeek of 2026-11-08: 1 commitsWeek of 2026-11-15: 0 commitsNov 23, 2025Nov 15, 2026
1.7K commits in the last 52 weeks.

When work happens

weekday and hour
SunMonTueWedThuFriSat036912151821Sun 0:00 — 12 commitsSun 1:00 — 14 commitsSun 2:00 — 15 commitsSun 3:00 — 24 commitsSun 4:00 — 12 commitsSun 5:00 — 0 commitsSun 6:00 — 12 commitsSun 7:00 — 14 commitsSun 8:00 — 9 commitsSun 9:00 — 0 commitsSun 10:00 — 3 commitsSun 11:00 — 2 commitsSun 12:00 — 1 commitsSun 13:00 — 1 commitsSun 14:00 — 20 commitsSun 15:00 — 14 commitsSun 16:00 — 12 commitsSun 17:00 — 25 commitsSun 18:00 — 26 commitsSun 19:00 — 28 commitsSun 20:00 — 14 commitsSun 21:00 — 21 commitsSun 22:00 — 24 commitsSun 23:00 — 16 commitsMon 0:00 — 23 commitsMon 1:00 — 17 commitsMon 2:00 — 12 commitsMon 3:00 — 12 commitsMon 4:00 — 6 commitsMon 5:00 — 0 commitsMon 6:00 — 0 commitsMon 7:00 — 2 commitsMon 8:00 — 2 commitsMon 9:00 — 5 commitsMon 10:00 — 0 commitsMon 11:00 — 1 commitsMon 12:00 — 16 commitsMon 13:00 — 13 commitsMon 14:00 — 19 commitsMon 15:00 — 21 commitsMon 16:00 — 10 commitsMon 17:00 — 19 commitsMon 18:00 — 14 commitsMon 19:00 — 20 commitsMon 20:00 — 14 commitsMon 21:00 — 8 commitsMon 22:00 — 10 commitsMon 23:00 — 20 commitsTue 0:00 — 23 commitsTue 1:00 — 20 commitsTue 2:00 — 20 commitsTue 3:00 — 4 commitsTue 4:00 — 2 commitsTue 5:00 — 0 commitsTue 6:00 — 0 commitsTue 7:00 — 0 commitsTue 8:00 — 0 commitsTue 9:00 — 2 commitsTue 10:00 — 7 commitsTue 11:00 — 7 commitsTue 12:00 — 9 commitsTue 13:00 — 6 commitsTue 14:00 — 18 commitsTue 15:00 — 12 commitsTue 16:00 — 16 commitsTue 17:00 — 17 commitsTue 18:00 — 7 commitsTue 19:00 — 16 commitsTue 20:00 — 16 commitsTue 21:00 — 19 commitsTue 22:00 — 13 commitsTue 23:00 — 17 commitsWed 0:00 — 13 commitsWed 1:00 — 16 commitsWed 2:00 — 7 commitsWed 3:00 — 8 commitsWed 4:00 — 2 commitsWed 5:00 — 1 commitsWed 6:00 — 4 commitsWed 7:00 — 2 commitsWed 8:00 — 0 commitsWed 9:00 — 0 commitsWed 10:00 — 2 commitsWed 11:00 — 1 commitsWed 12:00 — 9 commitsWed 13:00 — 18 commitsWed 14:00 — 9 commitsWed 15:00 — 16 commitsWed 16:00 — 12 commitsWed 17:00 — 19 commitsWed 18:00 — 12 commitsWed 19:00 — 21 commitsWed 20:00 — 9 commitsWed 21:00 — 12 commitsWed 22:00 — 17 commitsWed 23:00 — 20 commitsThu 0:00 — 12 commitsThu 1:00 — 14 commitsThu 2:00 — 4 commitsThu 3:00 — 1 commitsThu 4:00 — 2 commitsThu 5:00 — 1 commitsThu 6:00 — 1 commitsThu 7:00 — 0 commitsThu 8:00 — 0 commitsThu 9:00 — 1 commitsThu 10:00 — 0 commitsThu 11:00 — 3 commitsThu 12:00 — 18 commitsThu 13:00 — 7 commitsThu 14:00 — 6 commitsThu 15:00 — 8 commitsThu 16:00 — 20 commitsThu 17:00 — 15 commitsThu 18:00 — 9 commitsThu 19:00 — 6 commitsThu 20:00 — 13 commitsThu 21:00 — 15 commitsThu 22:00 — 19 commitsThu 23:00 — 13 commitsFri 0:00 — 19 commitsFri 1:00 — 25 commitsFri 2:00 — 15 commitsFri 3:00 — 8 commitsFri 4:00 — 2 commitsFri 5:00 — 1 commitsFri 6:00 — 0 commitsFri 7:00 — 0 commitsFri 8:00 — 0 commitsFri 9:00 — 2 commitsFri 10:00 — 19 commitsFri 11:00 — 11 commitsFri 12:00 — 6 commitsFri 13:00 — 7 commitsFri 14:00 — 18 commitsFri 15:00 — 6 commitsFri 16:00 — 16 commitsFri 17:00 — 25 commitsFri 18:00 — 13 commitsFri 19:00 — 14 commitsFri 20:00 — 14 commitsFri 21:00 — 2 commitsFri 22:00 — 7 commitsFri 23:00 — 4 commitsSat 0:00 — 25 commitsSat 1:00 — 19 commitsSat 2:00 — 13 commitsSat 3:00 — 2 commitsSat 4:00 — 0 commitsSat 5:00 — 0 commitsSat 6:00 — 0 commitsSat 7:00 — 0 commitsSat 8:00 — 2 commitsSat 9:00 — 4 commitsSat 10:00 — 5 commitsSat 11:00 — 3 commitsSat 12:00 — 9 commitsSat 13:00 — 8 commitsSat 14:00 — 9 commitsSat 15:00 — 7 commitsSat 16:00 — 9 commitsSat 17:00 — 9 commitsSat 18:00 — 15 commitsSat 19:00 — 8 commitsSat 20:00 — 12 commitsSat 21:00 — 18 commitsSat 22:00 — 7 commitsSat 23:00 — 11 commits
Commit volume by weekday and hour (UTC). Larger dots mean more commits.

Who is committing

last 52 weeks
Maintainer commits979 (58%)
Community commits709 (42%)

1,688 commits in total over the last year.

  • morluto/rea

    Reverse engineer anything with agents, from app behavior down to native binaries.

    471.6K stars · TypeScript

  • affaan-m/ECC

    The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

    307.9K stars · JavaScript

  • NousResearch/hermes-agent

    The agent that grows with you

    265K stars · Python

  • react/react

    The library for web and native user interfaces.

    252.8K stars · JavaScript

  • n8n-io/n8n

    Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

    211.6K stars · TypeScript

  • yt-dlp/yt-dlp

    A feature-rich command-line audio/video downloader

    209.4K stars · Python