Uni-CLI

Start In 30 Seconds

npm install -g @zenalexa/unicli
unicli search "hacker news frontpage"
unicli hackernews top --limit 5 -f json
npx @zenalexa/unicli mcp serve

| Need | Command | | ---------------------------- | ------------------------------------------------------ | | Find a capability | unicli search "summarize reddit thread" | | Inspect installed coverage | unicli list, unicli list --site macos | | Run with a machine contract | unicli <site> <command> -f json | | Download and read papers | unicli arxiv download <id> && unicli pdf read <file> | | Find ACG/tagged media | unicli search "Sparkle Honkai Star Rail character" | | Fix a broken adapter locally | unicli repair <site> <command> | | Serve tools to agents | npx @zenalexa/unicli mcp serve --expanded |

What It Does

Uni-CLI sits under agent applications and turns software surfaces into commands that agents can discover, execute, record, and repair.

| Surface | What you get | | ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Websites and APIs | Declarative adapters for public, cookie, header, and browser-intercept workflows | | Browser automation | CDP steps for navigate, click, type, intercept, snapshot, extract, wait, and related browser work | | Desktop and macOS | System commands, app adapters, real-time Shortcuts/App Intent discovery, screenshots, clipboard, calendar, brightness, and local tools | | External CLIs | 58 registered pass-through bridges with install/status discovery | | Agent backends | Route matrix for native CLI, JSON stream, MCP, ACP, HTTP API, OpenAI-compatible, and bridge routes | | Operation policy | open, confirm, and locked profiles with effect/risk scopes, local deny rules, --yes, and persisted approval memory | | Evidence | Run traces with environment snapshots, probe/replay/compare scores, structured gate results, browser session leases with tab/auth posture, render-aware evidence, movement checks, and stale-ref details | | Output | v2 AgentEnvelope in Markdown, JSON, YAML, CSV, or compact format | | Repair | Structured errors with adapter_path, failing step, retryability, suggestions, and alternatives |

For Agents

Use search first, then run the smallest matching command.

unicli search "connect slack messages" --limit 5
unicli slack search "deploy incident" -f json
unicli anilist characters "Sparkle" --limit 5 -f json
unicli danbooru tags sparkle --limit 5 -f json
unicli arxiv download 1706.03762 --output ./papers -f json
unicli pdf read ./papers/1706.03762.pdf --first_page 1 --last_page 3 -f json
unicli macos app-actions --app WhatsApp -f json
unicli macos automation-smoke -f json
unicli repair slack search

Output defaults to structured Markdown for non-TTY and agent-user-agent runs. Force a machine format when you need one:

UNICLI_OUTPUT=json unicli reddit hot --limit 10
unicli hackernews top --limit 5 -f yaml
unicli --record --permission-profile confirm twitter search "coding agents" -f json
unicli runs list -f json
unicli runs show <run_id> -f json
unicli runs probe <run_id> -f json
unicli runs replay <run_id> --permission-profile confirm --yes --min-score 1 --min-context-score 1 --min-overall-score 1 -f json
unicli runs compare <run_id> <replay_run_id> -f json
unicli runs compare <run_id> <replay_run_id> --min-score 1 --min-context-score 1 --min-overall-score 1 -f json
unicli --permission-profile locked --yes --remember-approval word set-font "Inter"
unicli approvals list -f json
unicli approvals revoke <approval_key> -f json
unicli browser evidence --render-aware --expect-domain example.com -f json

Protocol entry points:

npx @zenalexa/unicli mcp serve
npx @zenalexa/unicli mcp serve --transport streamable --port 19826
unicli acp
unicli agents recommend codex
unicli agents matrix

ACP is supported for editors and bridge tooling. The primary runtime path stays native CLI, JSON stream, or MCP when those routes are available.

Local Computer Control

unicli compute controls installed apps through native accessibility, Electron CDP, and visual fallback transports.

unicli compute apps
unicli compute snapshot --app Calculator --format compact
unicli compute find --role button --name 5 --first
unicli compute find --role input --text 8 --first
unicli compute click @e7
unicli doctor compute --json
npx @zenalexa/unicli mcp serve --profile computer-use

Start with Compute, Electron App Control, and Compute Troubleshooting.

Coverage

The catalog is intentionally broad. Every command is discoverable, typed, and repairable. Recent coverage includes scholarly paper download/read workflows, ACG/anime/manga/wiki discovery, booru tag search, visual-novel catalogs, and Japanese/romaji-aware entity lookup.

The wall below is generated from active manifest sites with real logo support. Badge counts exclude quarantined commands. The full generated catalog stays in unicli list and the docs site.