HKUDS/CLI-Anything · 60.7k stars · Intermediate · 15 min · 2026-11-20

Make any software agent-native with CLI-Anything

CLI-Anything gives agents a package manager for ready-made CLIs (CLI-Hub) and a 7-phase generator that builds a new agent-ready CLI for software that has none.

TL;DR

CLI-Anything bridges AI agents and software built for humans. You can install existing agent-native CLIs through the CLI-Hub package manager, or point a coding agent at a codebase and let the 7-phase generator build a new CLI with JSON output, a REPL and tests. The repo is Apache 2.0 licensed.

Why this repo matters

The README's pitch is that "Today's Software Serves Humans. Tomorrow's Users will be Agents." A CLI is a good agent interface: text commands match LLM format and chain together, --help is self-describing, and structured JSON output removes parsing guesswork. CLI-Anything packages that idea twice: a registry of community-built CLIs for apps like GIMP, Blender and LibreOffice, and a generator for software the registry does not cover.

Best practices

  • Start with the registry, build second. The README's quick start has two equal paths: use existing CLIs through CLI-Hub, or build a new one when the registry lacks it.
  • Install the real software too. The README notes that a CLI wrapping GIMP, Blender or LibreOffice still needs that upstream application installed. HARNESS.md makes the real software a hard dependency and says not to reimplement rendering in Python.
  • Always ask for --json. HARNESS.md requires every command to support --json for machine parsing, and asks for info, list and status commands so agents can inspect state before acting.
  • Verify outputs, not exit codes. HARNESS.md says "it ran without errors" is not sufficient; exports must be checked programmatically, and E2E tests must produce real files.
  • Refine in rounds. After the first build, /cli-anything:refine runs a gap analysis; the README says each run is incremental and non-destructive.
  • Give the agent the meta-skill. cli-hub-meta-skill lets SKILL-compatible agents discover and install the right CLI by themselves.

How-to

Where do I start?

1. Where do I get the package manager?

Install CLI-Hub, then browse. The README lists list, search, info, install, update, uninstall and launch.

pip install cli-anything-hub
cli-hub list
cli-hub search image

Next: Install a ready-made CLI

Try it

Install cli-anything-hub, run cli-hub search with a keyword for an app you already use, then cli-hub info <name> on one hit. Read what the entry says it requires before you install anything.

Pitfalls

  • Missing upstream app. The CLI is a wrapper; without the real software installed it cannot render or export. Install the app first.
  • Unknown skill in Claude Code. The README says to reload plugins, verify with /help cli-anything, and reinstall from the marketplace; on older builds try /cli-anything:cli-anything.
  • Windows shells. The README notes Claude Code runs commands through bash, so install Git for Windows or use WSL to avoid cygpath: command not found.
  • Registry entries are community-built. Review a CLI with cli-hub info before installing it, as with any package.

Next steps