Skip to content
Skills Library
AI & agents · Learning & explanation

unicli-usage

/unicli-usage

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.

Repository
uni-cli ↗
Licence
Apache-2.0
Last repository change
10.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 10.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

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.

Original author 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.

How it works

  1. Quick Reference
  2. Output Formats
  3. Adapter Types
  4. Exit Codes
  5. Auth and Browser Reuse
  6. Personalized Operations
Original SKILL.md headings · 133 lines, 727 words
SKILL.md preview
---
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`.

| Format    | Use Case                            |
| --------- | ----------------------------------- |
| `md`      | Default v2 AgentEnvelope for agents |
| `json`    | Machine parsing / jq                |
| `yaml`    | Config-friendly envelope            |
| `csv`     | Spreadsheet import                  |
| `compact` | Pipe-friendly row stream            |

```bash
unicli hackernews top -f json | jq '.data[0].title'
unicli hackernews top -f csv > stories.csv
```

## Adapter Types

| Type      | Description              | Example              |
| --------- | ------------------------ | -------------------- |
| `web-api` | REST API calls           | hackernews, bilibili |
| `desktop` | Local desktop software   | blender, gimp        |
| `browser` | Full browser automation  | xiaohongshu          |
| `bridge`  | Existing CLI passthrough | gh, docker           |
| `service` | HTTP services            | ollama, comfyui      |

## Exit Codes

Use exit codes for scripting.

```bash
unicli hackernews top || echo "exit $?"
[ $? -eq 77 ] && echo "Login required"
```

| Code | Meaning             |
| ---- | ------------------- |
| 0    | Success             |
| 66   | Empty result        |
| 69   | Service unavailable |
| 77   | Auth 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.

## 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.

Versions

The database has no other skills named unicli-usage.

Database snapshot: 13.11.2026 · package version 44a8db495df8 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100unicli
    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,…
  • 100unicli-explorer
    Create new Uni-CLI adapters by exploring websites and APIs. Use when adding support for a new site, desktop app, or service that unicli doesn't cover yet.
  • 100open-computer-use
    Platform-neutral guidance for using Open Computer Use, the open-source Computer Use MCP server and CLI for macOS, Linux, and Windows. Use when an agent needs to install, verify, troubleshoot, configure, or operate Open Computer Use through its native CLI, stdio MCP server, or…
  • 100computer-use
    Operate web pages in Emperor's built-in browser with the browser_* tools, and macOS app windows with the desktop_* tools — open or bind a target, read it, fill, click or type, and verify the result. Use when a task needs a real web page or app window (a form, a dashboard, a site…
  • 100opencli
    Interact with 80+ websites and desktop apps from the CLI via Chrome session reuse — zero LLM cost, deterministic JSON/YAML/CSV output. Covers Twitter/X, Reddit, YouTube, HN, Instagram, Spotify, Amazon, LinkedIn, and more; also automates browser actions and registers local CLI…
  • 100agent-browser
    Use when the task needs a real web browser inside the sandbox - open a page, click, fill forms, take screenshots, extract or scrape data, test a web app, or use a site that needs a login. Drives the preinstalled agent-browser CLI; the browser window shows on the user's Desktop…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.