olo-dot-io/uni-cli/unicli-hermes

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 json or set UNICLI_OUTPUT=json
• Errors: structured envelope to stderr with adapter_path, step, suggestion

Self-Repair

When a command fails:

1. Read the error JSON — it includes the adapter file path
2. Read the YAML adapter (~20 lines)
3. Fix the issue (selector changed? API versioned? auth needed?)
4. Save to ~/.unicli/adapters/<site>/<command>.yaml
5. 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"]