opencli-usage
opencli-usage
OpenCLI turns any website, Electron desktop app, or external CLI into a uniform opencli <site> <command> surface that agents can drive without screen-scraping. This skill is the orientation layer — once you know what you want to do, load one of the specialized skills below.
The three pillars
- Adapter commands —
opencli <site> <command> [...]. Built-in adapters live inclis/, user adapters in~/.opencli/clis/. Each is backed by a strategy (PUBLIC | COOKIE | INTERCEPT | UI | LOCAL) that tells you whether a Chrome session is needed. - Browser driving —
opencli browser *subcommands (open,state,click,type,select,find,extract,network, …) for ad-hoc interaction and scraping when no adapter covers the task. Seeopencli-browser. - Current-tab binding —
opencli browser <session> bindattaches the Chrome tab the user already opened/logged into to that browser session. Follow-up commands useopencli browser <session> .... Seeopencli-browserbefore using it; bound sessions still block tab mutation. - External CLI passthrough —
opencli gh,opencli docker,opencli vercel, etc. Managed viaopencli external install <name>(auto-install fromexternal-clis.yaml) oropencli external register <name>(bring your own).
Install
# npm global
npm install -g @jackwener/opencli # binary: opencli, requires Node >= 21
opencli doctor # run before browser-dependent work (see below)
More from jackwener/opencli
smart-search
基于 opencli 命令的智能搜索路由器。当用户想要使用 OpenCLI、CLI 或 API 搜索、查询、查找或研究信息时,尤其是涉及指定网站、社交媒体、技术资料、新闻、购物、旅游、求职、金融或中文内容时,务必使用此 skill
9.6Kopencli-browser
Use when an agent needs to drive a real Chrome window via opencli — inspect a page, fill forms, click through logged-in flows, or extract data ad-hoc. Covers the selector-first target contract, compound form fields, stale-ref handling, network capture, and the agent-native envelopes the CLI returns. Not for writing adapters — see opencli-adapter-author for that.
8.7Kopencli-autofix
Automatically fix broken OpenCLI adapters when commands fail. Load this skill when an opencli command fails — it guides you through collecting a trace artifact, patching the adapter, retrying, and filing an upstream GitHub issue after a verified fix. Works with any AI agent.
8.4Kopencli-adapter-author
Use when writing an OpenCLI adapter for a new site or adding a new command to an existing site. Guides end-to-end from first recon through field decoding, adapter coding, and verify. Replaces opencli-oneshot / opencli-explorer. For ad-hoc browser driving (no adapter), see opencli-browser instead; for a top-level orientation to opencli, see opencli-usage.
6.5Kopencli-explorer
Use when creating a new OpenCLI adapter from scratch, adding support for a new website or platform, exploring a site's API endpoints via browser DevTools, or when a user asks to automatically generate a CLI for a website (e.g. "帮我生成 xxx.com 的 cli"). Covers automated generation, API discovery workflow, authentication strategy selection, TS adapter writing, and testing.
4.0Kopencli-oneshot
Use when quickly generating a single OpenCLI command from a specific URL and goal description. 4-step process — open page, capture API, write TS adapter, test. For full site exploration, use opencli-explorer instead.
3.9K