/unicli-hermes

name: unicli-hermes
description: >
  Use Uni-CLI to interact with the current website, desktop-app, and system-tool catalog.
  Trigger when: user asks to check a website, fetch data, control a desktop app,
  or interact with social media, news, finance, or AI platforms.
version: 1.3.0
depends-on:
  - human-writing
triggers:
  - "unicli"
  - "website"
  - "fetch from"
  - "check twitter"
  - "bilibili"
  - "hackernews"

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"]