Agent skill

CLI-Anything for Hermes Agent

by HKUDS in HKUDS/CLI-Anything

Guides Hermes Agent through building, refining and testing a CLI-Anything harness that wraps a GUI application or source repository in a scriptable command line.

Apache-2.0Auto-check passedDevelopment

Install CLI-Anything for Hermes Agent

skills CLI
$ npx skills add HKUDS/CLI-Anything --skill cli-anything-hermes -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install HKUDS/CLI-Anything cli-anything-hermes --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/HKUDS/CLI-Anything.git skills-src && mkdir -p .claude/skills && cp -r skills-src/hermes-skill .claude/skills/cli-anything-hermes && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
cli-anything-hermes
GitHub stars
52k
Token cost
~1.1k tokens
SKILL.md length
497 words
Files
4 (incl. scripts)
Skills in repo
78
Repo updated
First seen
Licence
Apache-2.0

At a glance

Guides Hermes Agent through building, refining and testing a CLI-Anything harness that wraps a GUI application or source repository in a scriptable command line.

  • Works in 3 steps: If this skill is being used from inside… → If that local file is unavailable, clone… → Only if both local and network retrieval…
  • Wrapping a GUI application or repository in a scriptable CLI harness
  • SKILL.md covers Inputs, Hermes Tool Bindings, Modes and Backend Rules, plus 4 more sections
  • Runs PowerShell and Shell scripts from its folder; calls pip; reaches github.com

What it does

Before building anything, the agent is told to look for the full CLI-Anything methodology: reading HARNESS.md from a local cli-anything-plugin folder if one is present, cloning that folder from the HKUDS/CLI-Anything repository if it is not, and falling back to the condensed rules in this file only if both attempts fail. Input is a local source path or a GitHub repository URL, with the software's name taken from the directory after cloning. Hermes builds harnesses by combining its terminal, execute_code, delegate_task, read_file and write_file, and patch tools, following the exact invocation syntax in the Hermes Agent documentation.

Three modes are covered. Build creates a new harness under an agent-harness folder with a stateful Click CLI that supports one-shot subcommands, a REPL as the default when no subcommand is given, a JSON output mode, and session state with undo and redo where the target software allows it. Refine starts from an inventory of existing commands and tests, runs a gap analysis against the target software, and prefers high-impact missing features and easy wrappers around existing APIs, never removing a command unless a breaking change is explicitly requested. Test plans coverage before writing it, keeping a unit-test file and a separate workflow and backend end-to-end test file.

When your agent uses it

  • Wrapping a GUI application or repository in a scriptable CLI harness
  • Adding missing commands to an existing CLI-Anything harness
  • Planning and writing tests for a generated harness
  • Pointing Hermes Agent at a local path or GitHub repo to automate

Example prompts

  • “Build a CLI-Anything harness for the software at this local path.”
  • “Refine the existing harness for this repo and add the missing export command.”
  • “Write unit and end-to-end tests for the harness we just built.”

Requirements

  • Hermes Agent with its terminal, execute_code, delegate_task, read_file/write_file and patch tools
  • Python, for the generated Click CLI

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. If this skill is being used from inside the CLI-Anything repository, read ../cli-anything-plugin/HARNESS.md first.
  2. If that local file is unavailable, clone or download cli-anything-plugin from https://github.com/HKUDS/CLI-Anything/tree/main/cli-anything…
  3. Only if both local and network retrieval fail, follow the condensed rules below.

What it can do on your machine

Read from SKILL.md and the folder at commit 34f5195. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (PowerShell and Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • pip

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

CLI-Anything for Hermes Agent loads about 1.1k tokens when it runs. Until then it costs about 65 tokens; SKILL.md has 497 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~65
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from HKUDS/CLI-Anything at commit 34f5195, republished under its Apache-2.0 licence (© HKUDS). 497 words, ~1,123 tokens.

Download SKILL.mdSave it as .claude/skills/cli-anything-hermes/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
cli-anything-hermes
description
Use when the user wants Hermes Agent to build, refine, test, or validate a CLI-Anything harness for a GUI application or source repository. Adapts the CLI-Anything methodology to Hermes without changing the generated Python harness format.

CLI-Anything for Hermes Agent

Use this skill when the user wants Hermes Agent to act like the CLI-Anything builder.

Before implementation, use the full methodology source of truth when available:

  1. If this skill is being used from inside the CLI-Anything repository, read ../cli-anything-plugin/HARNESS.md first.
  2. If that local file is unavailable, clone or download cli-anything-plugin from https://github.com/HKUDS/CLI-Anything/tree/main/cli-anything-plugin, then use HARNESS.md and the resources around it from that folder.
  3. Only if both local and network retrieval fail, follow the condensed rules below.

Inputs

Accept either:

  • A local source path such as ./gimp or /path/to/software
  • A GitHub repository URL

Derive the software name from the local directory name after cloning if needed.

Hermes Tool Bindings

Hermes agents build harnesses by combining these built-in tools:

ToolRole in Harness Workflow
terminalRun shell commands, install packages, execute CLI tools, run tests
execute_codeGenerate and write Python files (Click CLI, backend modules, tests)
delegate_taskParallelize analysis or generation subtasks
read_file / write_fileRead and write harness source files
patchMake targeted edits to generated code

Consult the Hermes Agent documentation for the exact tool invocation syntax.

Modes

Build

Use when the user wants a new harness.

Produce this structure:

text
<software>/
└── agent-harness/
    ├── <SOFTWARE>.md
    ├── setup.py
    └── cli_anything/
        └── <software>/
            ├── README.md
            ├── __init__.py
            ├── __main__.py
            ├── <software>_cli.py
            ├── core/
            ├── utils/
            └── tests/

Implement a stateful Click CLI with:

  • one-shot subcommands
  • REPL mode as the default when no subcommand is given
  • --json machine-readable output
  • session state with undo/redo where the target software supports it
Refine

Use when the harness already exists.

First inventory current commands and tests, then do gap analysis against the target software. Prefer:

  • high-impact missing features
  • easy wrappers around existing backend APIs or CLIs
  • additions that compose well with existing commands

Do not remove existing commands unless the user explicitly asks for a breaking change.

Test

Plan tests before writing them. Keep both:

  • test_core.py for unit coverage
  • test_full_e2e.py for workflow and backend validation

When possible, test the installed command via subprocess using cli-anything-<software> rather than only module imports.

Show full SKILL.md (183 more words)Show less
Validate

Check that the harness:

  • uses the cli_anything.<software> namespace package layout
  • has an installable setup.py entry point
  • supports JSON output
  • has a REPL default path
  • documents usage and tests

Backend Rules

Prefer the real software backend over reimplementation. Wrap the actual executable or scripting interface in utils/<software>_backend.py when possible. Use synthetic reimplementation only when the project explicitly requires it or no viable native backend exists.

Packaging Rules

  • Use find_namespace_packages(include=["cli_anything.*"])
  • Keep cli_anything/ as a namespace package without a top-level __init__.py
  • Expose cli-anything-<software> through console_scripts

Workflow

  1. Acquire the source tree locally (clone or use existing path).
  2. Analyze architecture, data model, existing CLIs, and GUI-to-API mappings.
  3. Design command groups and state model.
  4. Implement the harness.
  5. Write TEST.md, then tests, then run them.
  6. Update README usage docs.
  7. Verify local installation with pip install -e .

Existing Harnesses (Reference)

For an up-to-date list of supported harnesses and their backend patterns, see registry.json at the repository root.

Output Expectations

When reporting progress or final results, include:

  • target software and source path
  • files added or changed
  • validation commands run
  • open risks or backend limitations

© HKUDS, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (scripts) in hermes-skill of HKUDS/CLI-Anything.

  • SKILL.md
  • agents/hermes.yaml
  • scripts/install.ps1
  • scripts/install.sh

Open the folder on GitHubat commit 34f5195

Compare with similar skills

CLI-Anything for Hermes Agent next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

CLI-Anything for Hermes Agent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
CLI-Anything for Hermes Agent this skillHKUDS/CLI-Anything52k—~1.1kAutomated safety check: PassApache-2.0
Mirage VFS Adapter Authoringstrukto-ai/mirage3.7k—~2.5kAutomated safety check: PassApache-2.0
Memory Starter Kitmage0535/hermes-memory-installer210—~363Automated safety check: PassMIT
MCP Scaffoldtimothywarner-org/claude-code224—~940Automated safety check: PassMIT
README and DESIGN Generatorfengshao1227/ccg-workflow5.9k—~410Automated safety check: NotesMIT
Project Scaffolderpretend1111/claude-desktop-app4961 repos~498Automated safety check: PassCustom licence

Similar skills

  • Builds or extends a custom Mirage virtual filesystem adapter for an API, database, object store or app data, with a working mount configuration and filesystem tests.

    3.7k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Memory Starter Kit

    mage0535/hermes-memory-installer

    Historical starter note for the memory sidecar stack. An agent skill from mage0535/hermes-memory-installer.

    210 GitHub stars~363 tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • MCP Scaffold

    timothywarner-org/claude-code

    Scaffold production-ready Python MCP servers using FastMCP. An agent skill from timothywarner-org/claude-code.

    224 GitHub stars~940 tokensUpdated 2 mo ago
    Agent WorkflowsAuto-check passed
  • README and DESIGN Generator

    fengshao1227/ccg-workflow

    Generates README.md and DESIGN.md skeletons for a module by scanning its structure with a Node script, then lists what to fill in by hand.

    5.9k GitHub stars~410 tokensUpdated 24 days ago
    DevelopmentAuto-check: notes
  • Project Scaffolder

    pretend1111/claude-desktop-app

    Scaffolds a complete, runnable project from scratch, covering web, Python and Node.js projects, with a working entry point and no placeholder code.

    496 GitHub starsUsed in 1 repo~498 tokens
    DevelopmentAuto-check passed
  • Python Packaging

    wshobson/agents

    Package and publish Python libraries and CLI tools: project layout, pyproject.toml, build backends, wheels and source distributions, versioning and PyPI releases.

    40k GitHub starsUsed in 12 repos~911 tokens
    DevelopmentAuto-check passed

More from HKUDS/CLI-Anything

All 78 skills in this repo
  • CLI-Anything for Codex

    HKUDS/CLI-Anything

    Lets Codex build, refine, test, validate and list CLI-Anything harnesses for GUI applications or source repositories, following the project's full methodology.

    52k GitHub stars~1.5k tokensUpdated 17 days ago
    Auto-check passed
  • CLI-Anything for Reasonix

    HKUDS/CLI-Anything

    Adapts the CLI-Anything methodology so Reasonix can build, refine, test and validate a command-line harness for an existing GUI application or source repository.

    52k GitHub stars~1.8k tokensUpdated 17 days ago
    Auto-check passed
  • Builds, refines, tests or validates a CLI-Anything harness that wraps a GUI application or source repository as a stateful Click CLI with JSON output and a REPL mode.

    52k GitHub stars~839 tokensUpdated 17 days ago
    Auto-check passed
  • Krita CLI Harness

    HKUDS/CLI-Anything

    Drives Krita from the command line to create projects, add layers, apply filters, resize the canvas and export images, with JSON output for agents.

    52k GitHub stars~931 tokensUpdated 17 days ago
    Auto-check passed
  • MacroCLI GUI Macros

    HKUDS/CLI-Anything

    Defines, lists, inspects and runs parameterized GUI macros from the command line, with the runtime choosing the execution backend.

    52k GitHub stars~1.4k tokensUpdated 17 days ago
    Auto-check passed
  • Capability-based matrix for video production in which the agent picks a provider per capability, from storyboard and sound design to captions, render checks and packaging.

    52k GitHub stars~12k tokensUpdated 17 days ago
    Auto-check passed

Works with

Questions about CLI-Anything for Hermes Agent

What does CLI-Anything for Hermes Agent do?

Guides Hermes Agent through building, refining and testing a CLI-Anything harness that wraps a GUI application or source repository in a scriptable command line. md from a local cli-anything-plugin folder if one is present, cloning that folder from the HKUDS/CLI-Anything repository if it is not, and falling back to the condensed rules in this file only if both attempts fail. Input is a local source path or a GitHub repository URL, with the software's name taken from the directory after cloning.

When should I use CLI-Anything for Hermes Agent?

CLI-Anything for Hermes Agent fits situations like: wrapping a GUI application or repository in a scriptable CLI harness; adding missing commands to an existing CLI-Anything harness; planning and writing tests for a generated harness; pointing Hermes Agent at a local path or GitHub repo to automate.

How do I install CLI-Anything for Hermes Agent in Claude Code?

Run `npx skills add HKUDS/CLI-Anything --skill cli-anything-hermes -a claude-code`. Or copy the skill folder (hermes-skill in HKUDS/CLI-Anything) into .claude/skills/cli-anything-hermes in your project. Claude Code loads it when a task matches its description.

How do I install CLI-Anything for Hermes Agent in Codex?

Run `npx skills add HKUDS/CLI-Anything --skill cli-anything-hermes -a codex`. Or copy the skill folder (hermes-skill in HKUDS/CLI-Anything) into .agents/skills/cli-anything-hermes in your project. Codex loads it when a task matches its description.

Can I use CLI-Anything for Hermes Agent in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HKUDS/CLI-Anything --skill cli-anything-hermes -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cli-anything-hermes, .gemini/skills/cli-anything-hermes, .github/skills/cli-anything-hermes and .opencode/skills/cli-anything-hermes in your project.

What does CLI-Anything for Hermes Agent need to run?

Going by SKILL.md and its folder, CLI-Anything for Hermes Agent needs PowerShell and a shell for the scripts in its folder and the command-line tools its instructions call (pip). Our summary lists: Hermes Agent with its terminal, execute_code, delegate_task, read_file/write_file and patch tools; Python, for the generated Click CLI.

Does CLI-Anything for Hermes Agent access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is CLI-Anything for Hermes Agent safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does CLI-Anything for Hermes Agent use?

CLI-Anything for Hermes Agent is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does CLI-Anything for Hermes Agent use?

About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to CLI-Anything for Hermes Agent?

Skills that share tags, products or a category with CLI-Anything for Hermes Agent: Mirage VFS Adapter Authoring (strukto-ai/mirage, 3.7k stars), Memory Starter Kit (mage0535/hermes-memory-installer, 210 stars), MCP Scaffold (timothywarner-org/claude-code, 224 stars) and README and DESIGN Generator (fengshao1227/ccg-workflow, 5.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains CLI-Anything for Hermes Agent?

HKUDS (a GitHub organization) maintains it in HKUDS/CLI-Anything, which has 51,768 GitHub stars. The repository holds 78 skills in this directory. The repository was last updated on September 22, 2026.

Source: HKUDS/CLI-Anything on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.