opencli-usage

name: opencli-usage description: Use when running OpenCLI commands on this remote server. Prefer public API adapters and CLI Hub passthrough on Linux; browser-backed website adapters require Chrome/Chromium, the OpenCLI Browser Bridge extension, and an interactive desktop session. version: 1.6.3 author: jackwener tags: [opencli, cli, linux, server, hackernews, arxiv, wikipedia, gh, docker, automation]

OpenCLI Usage on `apps/remote-server`

Use this skill when the task can benefit from OpenCLI's built-in adapters or CLI passthrough.

Runtime Reality on This Host

opencli is installed globally and can be invoked directly.
This host is a Linux server without a guaranteed interactive Chrome session.
Prefer commands that do not require a browser.
Treat browser-backed adapters as unavailable unless the user explicitly provides a desktop session with Chrome/Chromium and the Browser Bridge extension installed.

Safe Default Workflow

Check whether the task can be solved with a public API adapter.
If not, check whether an existing local CLI should be called through OpenCLI's CLI Hub.
Only suggest browser-backed adapters when the environment requirement is clearly satisfied.

High-Value Commands for This Server

Public API Adapters

These work without Chrome:

opencli hackernews top --limit 10 --format json
opencli hackernews search "agents"
opencli arxiv search "coding agents"
opencli wikipedia summary "OpenCLI"
opencli stackoverflow search "vitest mock"
opencli bbc news
opencli devto top
opencli hf top
opencli yahoo-finance quote AAPL

Commonly useful public adapters:

hackernews: top new best ask show jobs search user
arxiv: search paper
wikipedia: search summary random trending
stackoverflow: hot search bounties unanswered
bbc: news
devto: top tag user
hf: top
dictionary: search synonyms examples
apple-podcasts: search episodes top
xiaoyuzhou: podcast podcast-episodes episode
yahoo-finance: quote
barchart: quote options greeks flow
sinafinance: news
lobsters: hot newest active tag
lesswrong: curated frontpage new top read comments
steam: top-sellers

CLI Hub

Use OpenCLI as a discovery and passthrough layer for local CLIs:

opencli gh pr list --limit 5
opencli docker ps
opencli lark-cli calendar +agenda
opencli register mycli

Output Formats

Prefer machine-readable output when the result will be summarized or piped:

opencli hackernews top --limit 5 --format json
opencli arxiv search "test-time compute" -f yaml
opencli wikipedia summary "TypeScript" -f md

Supported formats: table, json, yaml, md, csv.

Browser-Backed Adapters

Examples: twitter, reddit, bilibili, zhihu, xiaohongshu, weibo, youtube, gemini, doubao.

Do not assume these are usable on this server. They require all of the following:

Chrome or Chromium running.
The OpenCLI Browser Bridge extension loaded in chrome://extensions.
A logged-in browser session for the target site.
An interactive desktop environment or equivalent remote GUI session.

If those prerequisites are not present, use a public API adapter, a direct API, or another automation stack instead.

Basic Checks

opencli --help
opencli list
opencli doctor

opencli doctor is only useful when trying to use browser-backed adapters.
A successful public API command is the quickest smoke test on this host.

Recommended Decision Rule

News, research, docs, rankings, finance snapshots: use OpenCLI public adapters.
Existing shell tooling: use OpenCLI CLI Hub if unified discovery is useful.
Logged-in websites and GUI automation: do not default to OpenCLI on this server.

OpenCLI Usage on apps/remote-server