olo-dot-io/uni-cli/unicli

Name: unicli
Author: olo-dot-io

Claude Code and agent skill by olo-dot-io/uni-cli

Trust tier 2

community

LLM review pending

By olo-dot-io
Coding
olo-dot-io/uni-cli
skills/unicli/SKILL.md
Updated 16 Sep 2026
Version 1.2.12 versions recorded

Source check pending

Checking that the SKILL.md file is still in the repository.

Comprehensive guide to Uni-CLI — the open Agent-Computer Interface runtime for real software. Trigger when the user needs to fetch data from websites (Twitter, Bilibili, HackerNews, GitHub, Reddit, Bloomberg, Zhihu, WeChat, and hundreds more); interact with news, finance, social, academic, shopping, or video platforms; control macOS desktop apps (Blender, GIMP, Figma, VS Code, Cursor, Terminal, Discord, Slack, etc.) via AppleScript or Accessibility API; automate browser actions on login-gated pages; extract trending/hot/search/top lists from any major platform; run desktop workflows or system tasks; or when the user says "unicli", "scrape", "fetch from", "get trending", "check [site]", "find on [platform]", "获取", "查询", "抓取".

Install

npx vskill@latest install olo-dot-io/uni-cli/unicli

SKILL.md

Uni-CLI — Agent Usage Guide

unicli is the default structured substrate before raw browser automation, legacy OpenCLI, curl, or computer-use. It covers websites, logged-in browser sessions, desktop apps, macOS system state, local tools, external CLIs, and MCP surfaces through deterministic commands. Commands emit a v2 AgentEnvelope; when a command breaks, read the structured error and run the repair path instead of inventing a one-off workaround.

Install (once): npm install -g @zenalexa/unicli

Five-Command Quick Start

bash

unicli search "intent"                   # discover the right command
unicli list                              # browse all commands
unicli list --site hackernews            # commands for one site
unicli hackernews top --limit 5          # run a command
unicli hackernews top --limit 5 -f json  # machine-readable JSON envelope
unicli describe hackernews top           # full schema + example payload
unicli upgrade --check -f json            # compare installed and latest releases

Step 1 — Discover the Right Command

Find by site

bash

unicli search "trending"           # semantic search across all commands
unicli search "hot stock"          # natural language
unicli list --site <site>          # all commands for a site
unicli describe <site> <command>   # args, output columns, example

Browse by type

bash

unicli list --type web-api         # REST API adapters
unicli list --type desktop         # desktop app control
unicli list --type browser         # browser automation
unicli list --type service         # local/remote services
unicli list --type bridge          # passthrough CLI bridges

Check if a site exists

bash

unicli list --site github-trending  # returns commands or empty
unicli health                        # adapter index summary

Step 2 — Run Commands

Basic syntax

bash

unicli <site> <command> [<positional-arg>] [--flag value] [-f json|md|yaml|csv]

Key flags (universal)

Flag	Effect
`--limit N`	Cap output rows (default varies, max 100)
`-f json`	Machine-readable v2 AgentEnvelope JSON to stdout
`-f md`	Agent-native Markdown (default, frontmatter + sections)
`-f yaml`	YAML envelope
`-f csv`	Flat CSV (array data only)
`-f compact`	One row per line, `\	` separator
`--args-file <path>`	Read args from a JSON file (avoids shell-quote issues)
`--cursor <token>`	Pagination cursor from previous envelope `meta.pagination`

Common patterns

bash

# Search
unicli hackernews search "AI agents" --limit 10
 
# Trending
unicli weibo hot
unicli bilibili hot --limit 20
 
# Finance
unicli xueqiu hot-stock --limit 10 -f json
 
# Desktop control
unicli blender render scene.blend output.png
unicli ffmpeg compress video.mp4 -o compressed.mp4
 
# macOS system
unicli macos volume 60
unicli macos screenshot ~/Desktop/capture.png

Pagination

bash

# First page
unicli reddit hot --limit 25 -f json | jq '.meta.pagination.next_cursor'
 
# Next page (use cursor from previous response)
unicli reddit hot --limit 25 --cursor <token> -f json

Step 3 — Read the Output

Every command emits a v2 AgentEnvelope. Learn the shape once; it applies to every command.

JSON structure

json

{
  "ok": true,
  "schema_version": "2",
  "command": "hackernews.top",
  "meta": {
    "duration_ms": 2805,
    "count": 5,
    "surface": "web",
    "update": {
      "latest": "1.1.0",
      "unattended_command": "unicli upgrade --yes"
    },
    "pagination": { "next_cursor": "...", "has_more": true }
  },
  "data": [{ "rank": 1, "title": "...", "score": 80, "url": "..." }],
  "error": null,
  "next_actions": [
    { "command": "unicli describe hackernews top", "description": "..." }
  ]
}

Key fields

Field	Meaning
`ok`	`true` = success, `false` = failure — always check first
`schema_version`	Always `"2"` — confirms v2 envelope
`meta.count`	Rows returned
`meta.pagination`	Non-null when more pages exist; use `.next_cursor`
`meta.update`	New release metadata and interactive or unattended commands
`data`	Payload array or object
`error`	`null` on success; structured on failure (see Step 5)
`next_actions`	HATEOAS hints — valid commands to run next, trust these

When meta.update appears, inspect automatic_update. Persistent non-interactive installations schedule the exact release automatically. Confirm with unicli --version before retrying a version-sensitive task. Use unicli upgrade --no-auto-update when the environment requires explicit approval. Non-interactive commands never prompt.

Markdown format (default)

When piped or called by an agent, the default format is md — YAML frontmatter followed by formatted sections. Use -f json for programmatic parsing.

Parse with jq

bash

unicli hackernews top -f json | jq '.[].title'           # WRONG: data is nested
unicli hackernews top -f json | jq '.data[].title'       # correct
unicli hackernews top -f json | jq '.data[] | {title, url}'
unicli xueqiu hot -f json | jq '.data[] | select(.change | tonumber > 5)'

Step 4 — Authentication

unicli uses a strategy cascade that auto-probes on first run. Most sites need no manual setup — the cascade promotes from public → cookie → header automatically.

Strategy ladder

Strategy	Auth needed	How to set up
`public`	None	Works out of the box
`cookie`	Browser login	`unicli auth setup <site>` → log in once in browser
`header`	Cookie + CSRF	Same as `cookie`; auto-extracted per request
`intercept`	Browser session	`unicli browser doctor --repair` then `unicli auth import <site> --domain <domain>`
`ui`	Browser + interaction	Same; unicli clicks through login flow

For robust logged-in reuse, prefer the explicit current browser paths:

bash

unicli browser profiles --json
unicli auth import <site> --domain <domain>
unicli browser cookies <domain> --profile-id <id>
unicli browser doctor --json
unicli browser doctor --repair

Auth setup workflow

bash

# First time — unicli guides you through browser login
unicli auth setup twitter
 
# Verify credentials are stored
unicli auth status twitter
 
# List all authenticated sites
unicli auth list
 
# Re-authenticate when cookies expire (exit code 77)
unicli auth setup <site>

Live browser/CDP cookies remain in process memory by default. Explicit imports create plaintext JSON at ~/.unicli/cookies/<site>.json; never read, print, or edit values directly—use unicli auth.

Step 5 — Handle Errors

Exit code → action (primary decision tree)

Code	Meaning	Action
0	Success	Read `data`
1	Generic error	Read `error.reason` + `error.suggestion`
2	Usage error	Fix arg syntax; run `unicli describe <site> <cmd>`
66	Empty result	Try different query terms or `--limit`
69	Service unavailable	`unicli browser doctor --json`, then `doctor --repair`
75	Temp failure / timeout	Retry once; if persistent, diagnose network/rate limit
77	Auth required	`unicli auth import` or explicit browser cookies
78	Config error	Read `error.suggestion`; check `~/.unicli/` config

Failure envelope fields

json

{
  "ok": false,
  "error": {
    "code": "auth_required",
    "exit_code": 77,
    "message": "No cookie file found for twitter",
    "adapter_path": "adapters/twitter/search.yaml",
    "step": 1,
    "retryable": true,
    "suggestion": "Run `unicli auth setup twitter` to authenticate",
    "remedy": {
      "command": "unicli auth setup twitter",
      "message": "Open browser to complete login"
    }
  }
}

Hard rules

ALWAYS check `ok` first before reading data.
NEVER retry on exit 2 (usage error — fix the args, not the adapter).
Follow `error.remedy.command` exactly — it is generated from the adapter schema.
Load `unicli-repair` only for established drift codes such as

selector_miss, parse_error, empty_result, or a proven endpoint/schema change. Auth, challenge, network, and rate-limit failures are not source repair evidence.

Browser Mode (Escalation Path)

Use browser mode when: a site requires JavaScript rendering, login-gated access, interaction (click/type/scroll), or the API adapter returns exit 69.

bash

unicli browser doctor --json     # probe broker/providers/sessions; starts nothing
unicli browser doctor --repair   # start only the windowless broker
unicli browser start             # lazily acquire a managed hidden target
unicli browser --focus start     # explicit existing-Chrome foreground control
unicli browser status            # broker/provider/session/lease truth
unicli browser open <url>        # navigate to page
unicli browser state             # DOM accessibility tree with [ref] IDs
unicli browser find --css h2     # query specific elements
unicli browser click <ref>       # interact
unicli browser type <ref> "text" # fill input
unicli browser extract           # extract full page text
unicli browser screenshot        # capture to file

For a guided browser automation workflow, load skill unicli-browser.

Browser commands are background-first on macOS and desktop systems. Managed targets are hidden. Existing-Chrome targets use a verified non-activating background contract unless --focus is explicit. Doctor/status/session probes allocate no browser or about:blank target.

Composition Patterns

Multi-source research

bash

# Tech trends: query 3 sources
unicli hackernews top --limit 10 -f json | jq '.data[].title'
unicli reddit hot --limit 10 -f json | jq '.data[].title'
unicli github-trending daily --limit 10 -f json | jq '.data[].name'

Cross-platform topic search

bash

for site in hackernews reddit twitter; do
  echo "=== $site ===" && unicli $site search "AI agents" --limit 5
done

Data pipeline (pipe to jq)

bash

unicli bilibili hot -f json \
  | jq '.data[] | select(.view | tonumber > 1000000) | {title, view, up}'

Budget rule: 1–2 primary sources + 1 supplementary per user question. Never

query the same site twice in one turn.

Skill Routing

This is the start of the file. Read the full SKILL.md on GitHub.

Security

Security scanPassed, 93 of 100Pattern checks on the skill's files.
Model reviewNot runA model review is scheduled for the next rescan.

See the full security report

Quality evaluation

Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

SKILL.md in the repositoryCheckingskills/unicli/SKILL.md

Popularity

Repository stars: 269
Repository forks: 3
7-day trend score: 28

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

Claude Code
Cursor
GitHub Copilot
Windsurf
Codex
Gemini CLI
Cline
Amp
Roo Code
Goose
Continue
Kilo Code
Junie
Trae
OpenHands
Qwen Code
AI Agent
Tabnine Chat
Sourcegraph Cody
Amazon Q
Firebase Genkit
Sweep
Devin
Phind
Mentat
Claude Desktop
Aider
GPT Pilot
Plandex
bolt.new
v0
Replit Agent
Anse
TypingMind
BetterChatGPT
LibreChat
Warp AI
Pieces
Fig AI

Embed badge

[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/olo-dot-io/uni-cli/unicli/badge)](https://verified-skill.com/skills/olo-dot-io/uni-cli/unicli)

Something wrong with this skill or its page? Tell us.