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 是一个项目,可以为现有软件生成面向智能体的原生命令行界面,让 AI 智能体(Claude Code、Codex、Pi、OpenClaw、Cursor 等)能够通过结构化的命令行命令控制这些软件,而不必依赖图形界面自动化。
这是一个命令行工具,还是需要装进我自己的智能体里的东西?两者兼有:'cli-anything-hub' 是一个可通过 pip 安装的包管理器,用于浏览和安装社区构建的命令行工具;核心仓库则是一个接入层生成器技能/插件,你可以把它添加到自己的编程智能体中,为其他软件构建新的命令行工具。
我该怎么开始使用?先用 pip install cli-anything-hub 安装 CLI-Hub 包管理器,然后使用 cli-hub list/search/info/install/update/uninstall/launch 浏览和运行现有的命令行工具;或者为你的智能体安装 CLI-Anything 插件/技能,并运行其 7 阶段的接入层生成器来构建新的命令行工具。
我必须使用某个特定的编程智能体才能用它吗?不需要指定某一个智能体。它明确支持 Pi、OpenClaw、nanobot、Cursor、Claude Code、Codex 等,因为生成的命令行工具是与智能体无关的结构化命令。
列出的所有接入层都同样稳定、安全吗?更新日志显示,许多接入层仍在持续进行安全加固和问题修复(如路径遍历修复、XML 注入防护、崩溃问题),因此质量因接入层而异,部分仍在修补中。
把技能安装到我的编程智能体里,最快的方法是什么?运行 'npx skills add HKUDS/CLI-Anything --skill -g -y',即可把 skills/ 顶层目录下所有统一的 SKILL.md 文件拉取到你的智能体中。
哪些软件已经有生成好的命令行工具?注册表中包含几十个接入层,涵盖创作、GIS、办公和开发工具,例如 Blender、GIMP、FreeCAD、QGIS、Obsidian、Zotero、Krita、MuseScore、Godot、Zoom 和 n8n。
作者为什么认为命令行是智能体的正确交互方式,而不是图形界面自动化?他们认为命令行结构化、可组合、轻量,并且可以通过 --help 自我描述,还能输出确定性的 JSON,省去了解析的复杂性,而图形界面自动化做不到这些。
如果注册表里还没有我需要的软件,能申请支持吗?可以。有一个开放的愿望清单流程,你可以提交针对某个特定软件或服务的请求,以便为其构建命令行工具。
Creator
HKUDS
Size
41.3 MB
Stars
53.6K
Age
7mo
Commits · 90 Days