# Unicli Hermes

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

- Skill: `olo-dot-io/unicli-hermes` (Agent Skill)
- Install (CLI): `npx skillmds@latest add olo-dot-io/unicli-hermes`
- Raw SKILL.md: https://api.skillmd.com/api/skills/olo-dot-io/unicli-hermes/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: olo-dot-io (https://skillmd.com/u/olo-dot-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/olo-dot-io/unicli-hermes

---


# Uni-CLI Agent Skill

Open Agent-Computer Interface runtime for real software. Run `unicli list` for
the live inventory.

## Install

```bash
npm install -g @zenalexa/unicli
```

## Quick Reference

```bash
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:

```yaml
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:

```yaml
mcp_servers:
  unicli:
    command: "npx"
    args: ["-y", "@zenalexa/unicli", "mcp", "serve", "--expanded"]
```