CLI-Anything README

The project's README from github.com/HKUDS/CLI-Anything. As one markdown file: README.md.

  CLI-Anything: Making ALL Software Agent-Native

HKUDS%2FCLI-Anything | Trendshift

Today's Software Serves Humans👨‍💻. Tomorrow's Users will be Agents🤖.
CLI-Anything: Bridging the Gap Between AI Agents and the World's Software

🌐 CLI-Hub: pip install cli-anything-hub then cli-hub install <name> — browse, install, and manage all community-built CLIs. Want to add your own? Open a PR — the hub updates instantly.

🎬 See Demos: Watch AI agents use generated CLIs plus preview, live preview, and trajectory loops to produce real artifacts — CAD builds, 3D scenes, diagrams, gameplay, subtitles, and more.

🙋 [Become a Contributor, or Request a CLI]: Join us! Sign up to build a new CLI harness — once reviewed and merged, you'll gain access as one of our community contributors! Wish CLI-Anything supported a specific software or service? Submit a wishlist request!

Quick Start CLI Hub Demos Tests Tech Report License

Python Click Pytest Coverage Output Feishu WeChat

One Command Line: Make any software agent-ready for Pi, OpenClaw, nanobot, Cursor, Claude Code, etc.  中文文档 | 日本語ドキュメント | Deutsch

CLI-Anything typing demo

CLI-Anything Teaser


📰 News

Thanks to all invaluable efforts from the community! More updates continuously on the way everyday..

Earlier news (Apr 10–18)
  • 2026-04-18 🧩 All SKILL.md files are now being unified under the top-level skills/ directory — every CLI skill can be installed from one canonical source with npx skills add HKUDS/CLI-Anything --skill <skill-name> -g -y. We also added root-skill validation CI, synced contribution / PR docs and REPL skill-path hints to the new layout, and refreshed the CLI-Hub install-first frontend around the new npx skills flow.

  • 2026-04-17 🌐 CLI-Hub received another install UX pass — public registry metadata and skill coverage were tightened, visit counting was corrected, and the web hub was further refined. 🧪 Shotcut render output duration was fixed (#92). 📝 SKILL contribution paths were corrected for the new docs flow (#224), and the skill generator now safely handles empty intros (#203).

  • 2026-04-16 🗺️ QGIS CLI merged (#207) — a full GIS / map authoring harness landed. 🧬 UniMol Tools CLI merged (#219) for molecular modeling workflows. 🌐 CLI-Hub also added more public CLIs, including py4csr, refreshed its generated meta-skill, corrected SKILL contribution docs, and fixed apt-get package extraction in skill generation (#204).

  • 2026-04-16 📈 Unreal Insights CLI expanded — added background capture session control (capture start/status/snapshot/stop), engine-root-matched UnrealInsights.exe resolution/build flows, and refreshed docs/tests for the new orchestration workflow.

  • 2026-04-15 🌐 CLI-Hub updated to v0.2.0 — the PyPI package now supports public CLIs from multiple install sources (pip, npm, brew, bundled/system tools), backed by a new public_registry.json. The Hub frontend was redesigned with separate CLI-Anything CLIs and Public CLIs decks, and live end-to-end checks now cover real install, update, and uninstall flows across both pip and npm packages.

  • 2026-04-14 🧭 Safari CLI merged (#212) and added to the Hub registry — browser automation via safari-mcp. 🎬 Kdenlive also received compatibility fixes for Gen 5 project output and invalid project generation.

  • 2026-04-13 📓 Obsidian CLI merged (#211) — knowledge management harness via the Local REST API, with 48 unit tests and 7 E2E tests. ⛓️ Eth2-Quickstart CLI merged (#195) — Ethereum staking node management harness. 📚 Zotero CLI updated to v0.4.1 (#201) — now shipped from its standalone repo, and CLI-Hub gained support for remote skill_md URLs.

  • 2026-04-11 🔗 n8n CLI merged (#188) — workflow automation harness for self-hosted automation flows. 🔧 Exa CLI fix (#205) added the x-exa-integration header for usage tracking. 📦 CLI-Hub also gained its PyPI auto-publish workflow and package refresh pipeline.

  • 2026-04-10 📦 CLI-Hub package manager launched — pip install cli-anything-hub to browse, search, install, update, and uninstall CLI-Anything harnesses from one command. The web Hub also shipped its first install-focused frontend refresh and "Empower yourself" toolkit card.

Earlier news (Apr 1–9)
  • 2026-04-09 🧹 Cleanup and docs pass (#200) — fixed Openscreen test subtotals, added Openscreen to the Chinese README and project structure, and clarified /cli-anything command syntax in the docs.

  • 2026-04-08 🎬 Openscreen CLI merged (#183) — screen recording editor harness with 101 tests. ☁️ CloudAnalyzer CLI merged (#181) — cloud cost analysis harness with 27 commands. 🌊 SeaClip / PM2 / ChromaDB harnesses merged (#129).

  • 2026-04-07 🔄 Dify Workflow CLI merged (#191) — workflow automation wrapper. 🔧 Inkscape auto-save fix (#193, fixes #182). 🛡️ DomShell security hardening (#156) — URL validation and DOM sanitization for the browser CLI. 🥧 Pi Coding Agent extension merged (#178).

  • 2026-04-06 🔍 Exa CLI merged (#172) — AI-powered web search and answers harness. 🎮 Godot CLI merged (#140) — game engine harness with a full demo-game E2E pipeline. ☁️ CloudAnalyzer review fixes and frontend improvements also landed.

  • 2026-04-03 🧪 WireMock CLI merged (#170) — HTTP mock server harness for API testing. 🥧 Pi Coding Agent extension support also landed, and CLI demo recordings were added to the docs.

  • 2026-04-01 ⚔️ Slay the Spire II CLI merged (#148) — deck-building roguelike harness. 🎥 VideoCaptioner CLI merged (#166) — AI-powered video captioning harness. 🛰️ IntelWatch was added to the registry for B2B OSINT workflows.

Earlier news (Mar 23–30)
  • 2026-03-30 🏗️ CLI-Anything v0.2.0 — HARNESS.md progressive disclosure redesign. Detailed guides extracted into guides/ for on-demand loading. Phases 1–7 now contiguous. Key Principles and Rules merged into a single authoritative section.

  • 2026-03-29 📐 Blender skill docs updated — enforce absolute render paths and correct prerequisites.

  • 2026-03-28 🌐 CLIBrowser added to CLI-Hub registry for agent-accessible browser automation.

  • 2026-03-27 📚 Zotero SKILL.md enhanced with agent-facing constraints; REPL config and executable resolution fixes.

  • 2026-03-26 📖 Zotero CLI harness landed for Zotero desktop (library management, collections, citations). Draw.io custom ID bugfix (#132) and registry.json syntax fix.

  • 2026-03-25 🎮 RenderDoc CLI merged for GPU frame capture analysis. FreeCAD updated for v1.1. Blender EEVEE engine name corrected. Zoom token permissions hardened.

  • 2026-03-24 🏭 FreeCAD CLI added with 258 commands across 17 groups. iTerm2 and Teltonika RMS harnesses added to registry.

  • 2026-03-23 🤖 Launched CLI-Hub meta-skill — agents can now discover and install CLIs autonomously. Krita CLI harness merged for digital painting.

Earlier news (Mar 11–22)
  • 2026-03-22 🎵 MuseScore CLI merged with transpose, export, and instrument management.

  • 2026-03-21 🔧 Infrastructure improvements — refined test harnesses and documentation across multiple CLIs. Enhanced Windows compatibility for several backends.

  • 2026-03-20 🌐 Novita AI CLI added for OpenAI-compatible API access. Registry metadata improvements for better hub discovery.

  • 2026-03-19 📦 Package structure refinements across harnesses. Improved SKILL.md generation with better command documentation.

  • 2026-03-18 🧪 Test coverage expansion — additional E2E scenarios and edge case validation across multiple CLIs.

  • 2026-03-17 🌐 Launched the CLI-Hub — a central registry where you can browse, search, and install any CLI with a single pip command.

  • 2026-03-16 🤖 Added SKILL.md generation (Phase 6.5) — every generated CLI now ships with an AI-discoverable skill definition.

  • 2026-03-15 🐾 Support for OpenClaw from the community! Merged Windows cygpath guard for cross-platform support.

  • 2026-03-14 🔒 Fixed a GIMP Script-Fu path injection vulnerability and added Japanese README translation.

  • 2026-03-13 🔌 Qodercli plugin officially merged as a community contribution with dedicated setup scripts.

  • 2026-03-12 📦 Codex skill integration landed, bringing CLI-Anything to yet another AI coding platform.

  • 2026-03-11 📞 Zoom video conferencing harness added as the 11th supported application.


🤔 Why CLI?

CLI is the universal interface for both humans and AI agents:

• Structured & Composable - Text commands match LLM format and chain for complex workflows

• Lightweight & Universal - Minimal overhead, works across all systems without dependencies

• Self-Describing - --help flags provide automatic documentation agents can discover

• Proven Success - Claude Code runs thousands of real workflows through CLI daily

• Agent-First Design - Structured JSON output eliminates parsing complexity

• Deterministic & Reliable - Consistent results enable predictable agent behavior

🚀 Quick Start

CLI-Anything has two equally useful starting points:

Goal Start Here
Use the existing CLI ecosystem now Install cli-anything-hub, browse the registry, and install ready-made CLIs.
Build a new agent-native CLI Install the CLI-Anything plugin/skill for your agent, then run the 7-phase harness generator.
Phase 1: Empower yourself — your CLI toolkit

Install the CLI-Hub package manager first. It lets you browse, search, inspect, install, update, uninstall, and launch CLI-Anything harnesses plus public third-party CLIs from one command.

PIP

pip install cli-anything-hub
Command What it does
cli-hub list Browse the registry
cli-hub search <query> Search by keyword
cli-hub info <name> Inspect one CLI
cli-hub install <name> Install from CLI-Hub
cli-hub update <name> Update an install
cli-hub uninstall <name> Remove an install
cli-hub launch <name> [args...] Run an installed CLI
# Browse what is available
cli-hub list
cli-hub search image

# Install and try a CLI immediately
cli-hub install gimp
cli-hub info gimp
cli-hub launch gimp

Some CLIs wrap real desktop or backend software. If a selected CLI needs GIMP, Blender, LibreOffice, or another upstream tool, install that upstream application too.

Phase 1.5: Empower your agents — install in one command

Give SKILL-compatible agents the CLI-Hub meta-skill so they can discover and install the right CLI for a task.

Also available on: ClawHub, SkillHub, SkillHub.cn

NPX SKILLS

npx skills add HKUDS/CLI-Anything --skill cli-hub-meta-skill -g -y

Works with: OpenClaw, Nanobot, Claude Code, Codex, Reasonix, Antigravity, and other SKILL-compatible agents.

Then prompt:

Find appropriate CLI software in CLI-Hub and complete the task: ...
Phase 3: Build a new CLI when the registry does not have one yet

Use the CLI-Anything generator when you need a new harness for software, a codebase, or an internal tool that is not already available through CLI-Hub.

Prerequisites

Pick Your Agent Platform

⚡ Claude Code

Step 1: Add the Marketplace

CLI-Anything is distributed as a Claude Code plugin marketplace hosted on GitHub.

# Add the CLI-Anything marketplace
/plugin marketplace add HKUDS/CLI-Anything

Step 2: Install the Plugin

# Install the cli-anything plugin from the marketplace
/plugin install cli-anything

That's it. The plugin is now available in your Claude Code session.

Note for Win Users: Claude Code runs shell commands via bash. On Windows, install Git for Windows (includes bash and cygpath) or use WSL; otherwise commands may fail with cygpath: command not found.

Step 3: Build a CLI in One Command

# /cli-anything <software-path-or-repo>
# Generate a complete CLI for GIMP (all 7 phases)
/cli-anything ./gimp

Command compatibility across Claude Code versions:

  • Use /cli-anything as the primary entrypoint.
  • On older builds where /cli-anything isn't recognized after confirming the plugin is installed and loaded, try the legacy entry form /cli-anything:cli-anything.
  • Auxiliary commands keep the :subcommand form (e.g. /cli-anything:refine).

If you see Unknown skill: cli-anything, focus on plugin install/load first (both entry forms reference the same skill, so swapping forms won't help):

  1. Reload plugin commands: /reload-plugins
  2. Verify the plugin is loaded: /help cli-anything (CLI-Anything help/commands should appear)
  3. Reinstall from marketplace if needed:
    • /plugin marketplace add HKUDS/CLI-Anything
    • /plugin install cli-anything
  4. After confirming the plugin is available, retry the entry command:
    • Preferred: /cli-anything ./gimp
    • Older builds only: /cli-anything:cli-anything ./gimp

This runs the full pipeline:

  1. 🔍 Analyze — Scans source code, maps GUI actions to APIs
  2. 📐 Design — Architects command groups, state model, output formats
  3. 🔨 Implement — Builds Click CLI with REPL, JSON output, undo/redo
  4. 📋 Plan Tests — Creates TEST.md with unit + E

CLI-Anything (HKUDS/CLI-Anything)

Searching Database…

Что это?CLI-Anything — это проект, который создаёт ориентированные на ИИ-агентов интерфейсы командной строки для существующего ПО, чтобы ИИ-агенты (Claude Code, Codex, Pi, OpenClaw, Cursor и др.) могли управлять этим ПО через структурированные CLI-команды, а не через автоматизацию графического интерфейса.
Это CLI-инструмент или то, что я устанавливаю в своего агента?Это два продукта в одном: 'cli-anything-hub' — менеджер пакетов, который устанавливается через pip и служит для поиска и установки CLI, созданных сообществом, а основной репозиторий — это навык/плагин-генератор обвязок (harness), который добавляется в вашего агента для написания кода, чтобы создавать новые CLI для других программ.
Как начать работу?Установите менеджер CLI-Hub командой pip install cli-anything-hub, затем используйте cli-hub list/search/info/install/update/uninstall/launch, чтобы просматривать и запускать готовые CLI, или установите плагин/навык CLI-Anything для вашего агента и запустите его 7-фазовый генератор обвязок (harness), чтобы создать новый CLI.
Нужен ли мне конкретный агент для программирования, чтобы использовать это?Нет, конкретный агент не обязателен: инструмент прямо поддерживает Pi, OpenClaw, nanobot, Cursor, Claude Code, Codex и другие, так как созданные CLI не привязаны к агенту и представляют собой структурированные команды.
Все ли перечисленные обвязки одинаково стабильны и безопасны?В журнале изменений видно постоянное усиление безопасности и исправление ошибок во многих обвязках (исправления обхода путей, защита от внедрения XML, исправления падений), поэтому качество разное, а некоторые обвязки всё ещё дорабатываются.
Какой самый быстрый способ установить навык в моего агента для программирования?Выполните команду 'npx skills add HKUDS/CLI-Anything --skill -g -y', чтобы загрузить все унифицированные файлы SKILL.md из каталога skills/ верхнего уровня в вашего агента.
Для какого ПО уже есть созданные CLI?В реестре есть десятки обвязок для творческих программ, ГИС, офисных и инструментов разработки, например Blender, GIMP, FreeCAD, QGIS, Obsidian, Zotero, Krita, MuseScore, Godot, Zoom и n8n.
Почему авторы считают, что для агентов лучше подходит CLI, а не автоматизация графического интерфейса?Они утверждают, что CLI структурирован и компонуем, легковесен, сам себя описывает через --help и выдаёт детерминированный JSON, что избавляет от сложного разбора вывода, в отличие от автоматизации GUI.
Можно ли запросить поддержку ПО, которого пока нет в реестре?Да, есть открытый список пожеланий: можно подать заявку на конкретное ПО или сервис, чтобы для него создали CLI.
Creator
HKUDS
Size
41.3 MB
Stars
54.2K
Age
7mo
Commits · 90 Days