Uni-CLI Agent Skill
Open Agent-Computer Interface runtime for real software. Run unicli list for
the live inventory.
Install
npm install -g @zenalexa/unicli
Quick Reference
unicli <site> <command> [--limit N] [-f json] # Run any command
unicli list [--site <name>] # Discover commands
unicli schema <site> <command> # Get input/output schema
unicli repair <site> <command> # Verify an evidence-backed fix
unicli test <site> # Validate adapter
When to Use
- Web data:
unicli twitter search "query",unicli hackernews top - Chinese platforms:
unicli bilibili hot,unicli zhihu trending - Finance:
unicli bloomberg latest,unicli xueqiu hot - Desktop apps:
unicli blender render scene.blend,unicli ffmpeg compress video.mp4 - macOS system:
unicli macos volume 50,unicli macos screenshot
Output
- Default: v2 AgentEnvelope rendered as Markdown
- JSON: pass
-f jsonor setUNICLI_OUTPUT=json - Errors: structured envelope to stderr with
adapter_path,step,suggestion
Self-Repair
When a command fails:
- Read the error JSON — it includes the adapter file path
- Read the YAML adapter (~20 lines)
- Fix the issue (selector changed? API versioned? auth needed?)
- Save to
~/.unicli/adapters/<site>/<command>.yaml - Verify:
unicli repair <site> <command>
unicli repair never edits source or invokes an AI backend. Do not offer it for
auth, challenge, network, or rate-limit failures; restore that boundary first.
MCP Server (Hermes / agentskills.io)
Add to your Hermes agent configuration:
mcp_servers:
unicli:
command: "npx"
args: ["-y", "@zenalexa/unicli", "mcp", "serve"]
tools:
include: [unicli_run, unicli_list, unicli_search, unicli_explore]
Or run the expanded server to expose each loaded adapter operation as an
individual full-schema tool. Use unicli mcp health -f json for the current
catalog-dependent count:
mcp_servers:
unicli:
command: "npx"
args: ["-y", "@zenalexa/unicli", "mcp", "serve", "--expanded"]