Agent skill

Unicli Usage

by olo-dot-io in olo-dot-io/Uni-CLI

Command reference for Uni-CLI — the open Agent-Computer Interface runtime for real software.

Apache-2.0Auto-check passedProductivity & Automation

Install Unicli Usage

skills CLI
$ npx skills add olo-dot-io/Uni-CLI --skill unicli-usage -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install olo-dot-io/Uni-CLI unicli-usage --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/olo-dot-io/Uni-CLI.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/unicli-usage .claude/skills/unicli-usage && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
unicli-usage
GitHub stars
274
Token cost
~1.5k tokens
SKILL.md length
361 words
Files
1
Skills in repo
11
Repo updated
First seen
Licence
Apache-2.0

At a glance

Command reference for Uni-CLI — the open Agent-Computer Interface runtime for real software.

  • Works in 4 steps: Run unicli browser doctor --json. → If default_path.available is true, run… → If false, run the first failing… → …
  • You need to discover
  • SKILL.md covers Quick Reference, Output Formats, Adapter Types and Exit Codes, plus 2 more sections
  • Calls jq

What it does

Unicli Usage is an agent skill from olo-dot-io/Uni-CLI. Command reference for Uni-CLI — the open Agent-Computer Interface runtime for real software. Use when you need to discover, run, or pipe unicli commands; or before using raw browser tools, legacy OpenCLI, curl, or computer-use for web, browser, desktop, macOS, local-tool, external-CLI, or adapter-repair tasks.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Desktop control. It works with macOS and Model Context Protocol. The repository describes itself as: One command for every interface—search, run, and inspect real software across APIs, browsers, desktops, local tools, and MCP. The licence is Apache-2.0.

When your agent uses it

  • You need to discover
  • Pipe unicli commands
  • Before using raw browser tools
  • Computer-use for web

Example prompts

  • “/unicli-usage”

Requirements

  • Docker

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Run unicli browser doctor --json.
  2. If default_path.available is true, run the requested command.
  3. If false, run the first failing checks[*].next_step; doctor --repair
  4. Classify the remaining structured envelope. Restore auth, challenge,

What it can do on your machine

Read from SKILL.md and the folder at commit 9316f93. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Unicli Usage loads about 1.5k tokens when it runs. Until then it costs about 81 tokens; SKILL.md has 361 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~81
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from olo-dot-io/Uni-CLI at commit 9316f93, republished under its Apache-2.0 licence (© olo-dot-io). 361 words, ~1,454 tokens.

Download SKILL.mdSave it as .claude/skills/unicli-usage/SKILL.md (or your agent's skills folder).
name
unicli-usage
description
Command reference for Uni-CLI — the open Agent-Computer Interface runtime for real software. Use when you need to discover, run, or pipe unicli commands; or before using raw browser tools, legacy OpenCLI, curl, or computer-use for web, browser, desktop, macOS, local-tool, external-CLI, or adapter-repair tasks.

unicli Usage Guide

Quick Reference

bash
unicli search "intent"                # Find the right command first
unicli do "goal" -f json              # Get candidates, schema, and next action
unicli describe <site> <command>      # Inspect exact args and recovery steps
unicli list                           # List all available commands
unicli list --type web-api            # Filter by adapter type
unicli list --site bilibili           # Filter by site name
unicli list --personalized            # Find signed-in user data operations
unicli search "my saved posts" --personalized

unicli upgrade --check -f json         # Compare installed and latest releases
unicli upgrade                         # Interactive Y/N choice
unicli upgrade --yes -f json           # Unattended Agent update
unicli upgrade --no -f json            # Remind again after 24 hours
unicli upgrade --no-auto-update         # Require explicit approval on this machine

unicli <site> <command> [options]     # Run any command
unicli hackernews top --limit 5       # Example: HN top stories
unicli hackernews search "AI agents"  # Example: search HN

unicli doctor                         # System health check
unicli browser doctor --json          # Browser/profile/CDP reliability report
unicli browser doctor --repair        # Start only the windowless broker
unicli browser start                  # Start hidden managed provider on demand
unicli browser --focus start          # Explicit existing-Chrome foreground control

Output Formats

Every structured envelope may include meta.update. Persistent non-interactive installations schedule the exact release automatically and expose progress in meta.update.automatic_update. Confirm the installed version before retrying a version-sensitive task. Non-interactive calls never open a prompt.

All commands support --format / -f.

FormatUse Case
mdDefault v2 AgentEnvelope for agents
jsonMachine parsing / jq
yamlConfig-friendly envelope
csvSpreadsheet import
compactPipe-friendly row stream
bash
unicli hackernews top -f json | jq '.data[0].title'
unicli hackernews top -f csv > stories.csv

Adapter Types

TypeDescriptionExample
web-apiREST API callshackernews, bilibili
desktopLocal desktop softwareblender, gimp
browserFull browser automationxiaohongshu
bridgeExisting CLI passthroughgh, docker
serviceHTTP servicesollama, comfyui

Exit Codes

Use exit codes for scripting.

bash
unicli hackernews top || echo "exit $?"
[ $? -eq 77 ] && echo "Login required"
CodeMeaning
0Success
66Empty result
69Service unavailable
77Auth required

Auth and Browser Reuse

bash
unicli browser profiles --json
unicli auth setup <site>
unicli auth import <site> --domain <domain>
unicli auth check <site>
unicli browser cookies <domain> --profile-id <id>
unicli repair <site> <command> # verifier after evidence-backed adapter edit

Browser operations are broker-owned and background-first. The default managed provider is hidden; the Chrome provider requires explicit background or foreground visibility. Doctor/status/session probes do not start the broker, browser providers, or placeholder tabs. --focus is the explicit foreground escape hatch.

Show full SKILL.md (195 more words)Show less

Personalized Operations

Use the shared personalization filter for the signed-in user's feed, saved library, network, account, and activity surfaces.

bash
unicli list --personalized
unicli list --site xiaohongshu --personalized
unicli search "my saved Xiaohongshu notes" --personalized
unicli describe xiaohongshu saved

Search and describe results expose personalization, auth, auth_setup, usage, and inspect where those fields apply. Execute the listed setup command before a personalized operation that requires cookies.

Chrome 136+ rejects CDP on the browser's default user-data-dir. Uni-CLI should therefore launch CDP against its own automation profile under ~/.unicli/ and reuse login state by importing cookies from unicli browser profiles --json. If chrome_remote_debugging.policy.state=disabled, the user/admin must remove RemoteDebuggingAllowed=false or set it true in Chrome policy, then restart Chrome; that policy does not bypass the default-profile restriction. If a browser command fails, diagnose the automation profile and cookie import path before asking the user to foreground Chrome.

Use this delivery sequence.

  1. Run unicli browser doctor --json.
  2. If default_path.available is true, run the requested command.
  3. If false, run the first failing checks[*].next_step; doctor --repair repairs only the broker control plane.
  4. Classify the remaining structured envelope. Restore auth, challenge, network, or rate-limit boundaries without editing the adapter. Only when current endpoint/DOM evidence proves selector/schema/endpoint drift, edit adapter_path and run unicli repair <site> <command> as the verifier.

© olo-dot-io, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/unicli-usage of olo-dot-io/Uni-CLI.

Open the folder on GitHubat commit 9316f93

Compare with similar skills

Unicli Usage next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Unicli Usage compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Unicli Usage this skillolo-dot-io/Uni-CLI274—~1.5kAutomated safety check: PassApache-2.0
Open Computer UseiFurySt/open-codex-computer-use2.4k—~1.5kAutomated safety check: PassMIT
Interceptor BrowserHacker-Valley-Media/Interceptor5171 repos~4.8kAutomated safety check: PassCustom licence
Browser MCP Agentantibrow/anti-detect-browser-skills9321 repos~4.2kAutomated safety check: WarnMIT
Altic Studioaltic-dev/altic-mcp173—~3.3kAutomated safety check: PassApache-2.0
Interceptor iOSHacker-Valley-Media/Interceptor517—~1.9kAutomated safety check: PassCustom licence

Similar skills

  • Open Computer Use

    iFurySt/open-codex-computer-use

    Platform-neutral guidance for using Open Computer Use, the open-source Computer Use MCP server and CLI for macOS, Linux, and Windows.

    2.4k GitHub stars~1.5k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Interceptor Browser

    Hacker-Valley-Media/Interceptor

    Drive a signed-in Chrome / Brave / Safari session via the interceptor CLI: open/read pages, click, type, inspect DOM/text/network, automate rich browser editors and scene graphs, capture…

    517 GitHub starsUsed in 1 repo~4.8k tokens
    Productivity & AutomationAuto-check passed
  • Browser MCP Agent

    antibrow/anti-detect-browser-skills

    Give an AI agent its own real browser over MCP tool calls - launch, navigate, click, fill, screenshot, extract text, run JS - with a kernel-level real-device fingerprint and a persistent profile, so…

    932 GitHub starsUsed in 1 repo~4.2k tokens
    Productivity & AutomationAuto-check: warnings
  • Altic Studio

    altic-dev/altic-mcp

    macOS automation skill for AppleScript actions and Chrome browser control via MCP CDP tools.

    173 GitHub stars~3.3k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Interceptor iOS

    Hacker-Valley-Media/Interceptor

    Drive any installed app on an owned, unlocked, Developer-Mode iPhone via interceptor ios : ref-tagged element trees, deterministic coordinate taps (click), reliable text entry (type/keys), scroll…

    517 GitHub stars~1.9k tokensUpdated 6 days ago
    Productivity & AutomationAuto-check passed
  • QA

    team-attention/hoyeon

    Systematically QA test any application — web apps, native macOS apps, Electron apps, CLI tools, interactive REPLs, or anything on screen.

    173 GitHub stars~2.6k tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check: notes

More from olo-dot-io/Uni-CLI

All 11 skills in this repo
  • Unicli

    olo-dot-io/Uni-CLI

    Comprehensive guide to Uni-CLI — the open Agent-Computer Interface runtime for real software.

    274 GitHub stars~3.8k tokensUpdated 4 days ago
    Auto-check: notes
  • Unicli Repair

    olo-dot-io/Uni-CLI

    Evidence-driven repair workflow for a broken Uni-CLI adapter.

    274 GitHub stars~1.5k tokensUpdated 4 days ago
    Auto-check: notes
  • Unicli Explorer

    olo-dot-io/Uni-CLI

    Create new Uni-CLI adapters by exploring websites and APIs. An agent skill from olo-dot-io/Uni-CLI.

    274 GitHub stars~659 tokensUpdated 4 days ago
    Auto-check: notes
  • Human Writing

    olo-dot-io/Uni-CLI

    通用中文创作与改稿 Skill。用于知乎回答、论坛长帖、公众号文章、博客、评论、人物故事、历史叙事、新闻与行业解读、科普、教程、评测、个人叙事、小说、故事、对白、口播和演讲稿。默认写成一个见过事、查过材料、愿意把来龙去脉讲清楚的人在说话,重点保留中文互联网长回答与长帖的活人感和自然中文韵律,避免空泛的机构腔、喊口号式演说腔、营销腔和模型腔。非虚构长文先检查材料够不够,材料不足时研究、追问或缩短,…

    274 GitHub starsUsed in 2 repos~1.7k tokens
    Auto-check passed
  • Unicli Hermes

    olo-dot-io/Uni-CLI

    Use Uni-CLI to interact with the current website, desktop-app, and system-tool catalog.

    274 GitHub stars~653 tokensUpdated 4 days ago
    Auto-check passed
  • Unicli Smart Search

    olo-dot-io/Uni-CLI

    Route search queries to the best platform via unicli. An agent skill from olo-dot-io/Uni-CLI.

    274 GitHub stars~1.9k tokensUpdated 4 days ago
    Auto-check: notes

Questions about Unicli Usage

What does Unicli Usage do?

Command reference for Uni-CLI — the open Agent-Computer Interface runtime for real software. Unicli Usage is an agent skill from olo-dot-io/Uni-CLI. Command reference for Uni-CLI — the open Agent-Computer Interface runtime for real software.

When should I use Unicli Usage?

Unicli Usage fits situations like: you need to discover; pipe unicli commands; before using raw browser tools; computer-use for web.

How do I install Unicli Usage in Claude Code?

Run `npx skills add olo-dot-io/Uni-CLI --skill unicli-usage -a claude-code`. Or copy the skill folder (skills/unicli-usage in olo-dot-io/Uni-CLI) into .claude/skills/unicli-usage in your project. Claude Code loads it when a task matches its description.

How do I install Unicli Usage in Codex?

Run `npx skills add olo-dot-io/Uni-CLI --skill unicli-usage -a codex`. Or copy the skill folder (skills/unicli-usage in olo-dot-io/Uni-CLI) into .agents/skills/unicli-usage in your project. Codex loads it when a task matches its description.

Can I use Unicli Usage in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add olo-dot-io/Uni-CLI --skill unicli-usage -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/unicli-usage, .gemini/skills/unicli-usage, .github/skills/unicli-usage and .opencode/skills/unicli-usage in your project.

What does Unicli Usage need to run?

Going by SKILL.md and its folder, Unicli Usage needs the command-line tools its instructions call (jq). Our summary lists: Docker.

Does Unicli Usage access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Unicli Usage safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Unicli Usage use?

Unicli Usage is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Unicli Usage use?

About 1.5k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Unicli Usage?

Skills that share tags, products or a category with Unicli Usage: Open Computer Use (iFurySt/open-codex-computer-use, 2.4k stars), Interceptor Browser (Hacker-Valley-Media/Interceptor, 517 stars), Browser MCP Agent (antibrow/anti-detect-browser-skills, 932 stars) and Altic Studio (altic-dev/altic-mcp, 173 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Unicli Usage?

olo-dot-io (a GitHub organization) maintains it in olo-dot-io/Uni-CLI, which has 274 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 4, 2026.

Source: olo-dot-io/Uni-CLI on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.