CLI-Anything: Making ALL Software Agent-Native

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](https://hkuds.github.io/CLI-Anything/)**: Explore all community-built CLIs and install with one command at the **[CLI-Hub](https://hkuds.github.io/CLI-Anything/)**. Want to add your own? [Open a PR](https://github.com/HKUDS/CLI-Anything/blob/main/CONTRIBUTING.md) โ€” the hub updates instantly.

Quick Start CLI Hub Demos Tests License

Python Click Pytest Coverage Output Feishu WeChat

**One Command Line**: Make any software agent-ready for OpenClaw, nanobot, Cursor, Claude Code, etc.  [**ไธญๆ–‡ๆ–‡ๆกฃ**](README_CN.md) | [**ๆ—ฅๆœฌ่ชžใƒ‰ใ‚ญใƒฅใƒกใƒณใƒˆ**](README_JA.md)

CLI-Anything typing demo

CLI-Anything Teaser

--- ## ๐Ÿ“ฐ News > Thanks to all invaluable efforts from the community! More updates continuously on the way everyday.. - **2026-03-23** ๐Ÿค– Launched **CLI-Hub meta-skill** โ€” agents can now discover and install CLIs autonomously via [`cli-hub-meta-skill/SKILL.md`](cli-hub-meta-skill/SKILL.md). The catalog auto-updates from `registry.json` via GitHub Actions, making the entire marketplace agent-native. - **2026-03-22** ๐ŸŽต **MuseScore CLI** merged with transpose, export, and instrument management. Community contributions continue expanding domain coverage. - **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](https://hkuds.github.io/CLI-Anything/)** โ€” a central registry where you can browse, search, and install any CLI with a single `pip` command. Contributors can add new CLIs or update existing ones by simply opening a PR with a `registry.json` entry. The hub updates automatically on merge.
Earlier news - **2026-03-16** ๐Ÿค– Added **SKILL.md generation** (Phase 6.5) โ€” every generated CLI now ships with an AI-discoverable skill definition inside the Python package. ReplSkin auto-detects the skill file after `pip install`, and the REPL banner displays the absolute path for agents. Includes `skill_generator.py`, Jinja2 template, `package_data` in all setup.py files, and 51 new tests. - **2026-03-15** ๐Ÿพ Support for **OpenClaw** from the community! Merged Windows `cygpath` guard to ensure CLI-Anything works reliably in Windows bash environments. Community contributions continue to strengthen cross-platform support. - **2026-03-14** ๐Ÿ”’ Fixed a GIMP Script-Fu path injection vulnerability and added **Japanese README** translation. OpenCode version requirements documented alongside several Windows compatibility improvements. - **2026-03-13** ๐Ÿ”Œ **Qodercli** plugin officially merged as a community contribution with dedicated setup scripts. Codex skill gained a Windows install script, and placeholder URLs were cleaned up across the project. - **2026-03-12** ๐Ÿ“ฆ **Codex skill** integration landed, bringing CLI-Anything to yet another AI coding platform. Qodercli support was also introduced, and documentation was updated with limitations and experimental labels. - **2026-03-11** ๐Ÿ“ž **Zoom** video conferencing harness added as the 11th supported application. Multiple community fixes shipped for Shotcut auto-save, LibreOffice Windows/macOS backend, and OpenCode support.
--- ## ๐Ÿค” 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 ### Prerequisites - **Python 3.10+** - Target software installed (e.g., GIMP, Blender, LibreOffice, or your own application) - A supported AI coding agent: [Claude Code](#-claude-code) | [OpenClaw](#-openclaw) | [OpenCode](#-opencode) | [Codex](#-codex) | [Qodercli](#-qodercli) | [GitHub Copilot CLI](#-github-copilot-cli) | [More Platforms](#-more-platforms-coming-soon) ### Pick Your Platform

โšก Claude Code

 **Step 1: Add the Marketplace** CLI-Anything is distributed as a Claude Code plugin marketplace hosted on GitHub. ```bash # Add the CLI-Anything marketplace /plugin marketplace add HKUDS/CLI-Anything ``` **Step 2: Install the Plugin** ```bash # 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** ```bash # /cli-anything:cli-anything # Generate a complete CLI for GIMP (all 7 phases) /cli-anything:cli-anything ./gimp # Note: If your Claude Code is under 2.x, use "/cli-anything" instead. ``` 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 + E2E test plans 5. ๐Ÿงช **Write Tests** โ€” Implements comprehensive test suite 6. ๐Ÿ“ **Document** โ€” Updates TEST.md with results 7. ๐Ÿ“ฆ **Publish** โ€” Creates `setup.py`, installs to PATH **Step 4 (Optional): Refine and Improve the CLI** After the initial build, you can iteratively refine the CLI to expand coverage and add missing capabilities: ```bash # Broad refinement โ€” agent analyzes gaps across all capabilities /cli-anything:refine ./gimp # Focused refinement โ€” target a specific functionality area /cli-anything:refine ./gimp "I want more CLIs on image batch processing and filters" ``` The refine command performs gap analysis between the software's full capabilities and current CLI coverage, then implements new commands, tests, and documentation for the identified gaps. You can run it multiple times to steadily expand coverage โ€” each run is incremental and non-destructive.
Alternative: Manual Installation If you prefer not to use the marketplace: ```bash # Clone the repo git clone https://github.com/HKUDS/CLI-Anything.git # Copy plugin to Claude Code plugins directory cp -r CLI-Anything/cli-anything-plugin ~/.claude/plugins/cli-anything # Reload plugins /reload-plugins ```

โšก OpenCode (Experimental)

 **Step 1: Install the Commands** > **Note:** Please upgrade to the latest OpenCode. Older versions may use a different commands path. Copy the CLI-Anything commands **and** `HARNESS.md` to your OpenCode commands directory: ```bash # Clone the repo git clone https://github.com/HKUDS/CLI-Anything.git # Global install (available in all projects) cp CLI-Anything/opencode-commands/*.md ~/.config/opencode/commands/ cp CLI-Anything/cli-anything-plugin/HARNESS.md ~/.config/opencode/commands/ # Or project-level install cp CLI-Anything/opencode-commands/*.md .opencode/commands/ cp CLI-Anything/cli-anything-plugin/HARNESS.md .opencode/commands/ ``` > **Note:** `HARNESS.md` is the methodology spec that all commands reference. It must be in the same directory as the commands. This adds 5 slash commands: `/cli-anything`, `/cli-anything-refine`, `/cli-anything-test`, `/cli-anything-validate`, and `/cli-anything-list`. **Step 2: Build a CLI in One Command** ```bash # Generate a complete CLI for GIMP (all 7 phases) /cli-anything ./gimp # Build from a GitHub repo /cli-anything https://github.com/blender/blender ``` The command runs as a subtask and follows the same 7-phase methodology as Claude Code. **Step 3 (Optional): Refine and Improve the CLI** ```bash # Broad refinement โ€” agent analyzes gaps across all capabilities /cli-anything-refine ./gimp # Focused refinement โ€” target a specific functionality area /cli-anything-refine ./gimp "batch processing and filters" ```

โšก Goose (Desktop / CLI) Experimental Community

 **Step 1: Install Goose** Install Goose (Desktop or CLI) using the official Goose instructions for your OS. **Step 2: Configure a CLI Provider** Configure Goose to use a CLI provider such as Claude Code, and make sure that CLI is installed and authenticated. **Step 3: Use CLI-Anything in a Goose Session** Once Goose is configured, start a session and use the same CLI-Anything commands described above for Claude Code, for example: ```bash /cli-anything:cli-anything ./gimp /cli-anything:refine ./gimp "batch processing and filters" ``` > Note: When Goose runs through a CLI provider, it uses that provider's capabilities and command format.

โšก Qodercli Community

 **Step 1: Register the Plugin** ```bash git clone https://github.com/HKUDS/CLI-Anything.git bash CLI-Anything/qoder-plugin/setup-qodercli.sh ``` This registers the cli-anything plugin in `~/.qoder.json`. Start a new Qodercli session after registration. **Step 2: Use CLI-Anything from Qodercli** ```bash /cli-anything:cli-anything ./gimp /cli-anything:refine ./gimp "batch processing and filters" /cli-anything:validate ./gimp ```

โšก OpenClaw Community

 **Step 1: Install the Skill** CLI-Anything provides a native OpenClaw `SKILL.md` file. Copy it to your OpenClaw skills directory: ```bash # Clone the repo git clone https://github.com/HKUDS/CLI-Anything.git # Install to the global skills folder mkdir -p ~/.openclaw/skills/cli-anything cp CLI-Anything/openclaw-skill/SKILL.md ~/.openclaw/skills/cli-anything/SKILL.md ``` **Step 2: Build a CLI** Now you can invoke the skill inside OpenClaw: `@cli-anything build a CLI for ./gimp` The skill follows the same 7-phase methodology as Claude Code and OpenCode.

โšก Codex Experimental Community

 **Step 1: Install the Skill** Run the bundled installer: ```bash # Clone the repo git clone https://github.com/HKUDS/CLI-Anything.git # Install the skill bash CLI-Anything/codex-skill/scripts/install.sh ``` On Windows PowerShell, use: ```powershell .\CLI-Anything\codex-skill\scripts\install.ps1 ``` This installs the skill to `$CODEX_HOME/skills/cli-anything` (or `~/.codex/skills/cli-anything` if `CODEX_HOME` is unset). Restart Codex after installation so it is discovered. **Step 2: Use CLI-Anything from Codex** Describe the task in natural language, for example: ```text Use CLI-Anything to build a harness for ./gimp Use CLI-Anything to refine ./shotcut for picture-in-picture workflows Use CLI-Anything to validate ./libreoffice ``` The Codex skill adapts the same methodology used by the Claude Code plugin and OpenCode commands, while keeping the generated Python harness format unchanged.

โšก GitHub Copilot CLI Community

 **Step 1: Install the Plugin** ```bash git clone https://github.com/HKUDS/CLI-Anything.git cd CLI-Anything copilot plugin install ./cli-anything-plugin ``` This installs the CLI-Anything plugin to GitHub Copilot CLI. The plugin should now be available in your GitHub Copilot CLI session. **Step 2: Use CLI-Anything from GitHub Copilot CLI** ```bash /cli-anything:cli-anything ./gimp /cli-anything:refine ./gimp "batch processing and filters" /cli-anything:validate ./gimp ```

๐Ÿ”ฎ More Platforms (Coming Soon)

 CLI-Anything is designed to be platform-agnostic. Support for more AI coding agents is planned: - **Codex** โ€” available via the bundled skill in `codex-skill/` - **Cursor** โ€” coming soon - **Windsurf** โ€” coming soon - **Your favorite tool** โ€” contributions welcome! See the `opencode-commands/` directory for a reference implementation.
### Use the Generated CLI Regardless of which platform you used to build it, the generated CLI works the same way: ```bash # Install to PATH cd gimp/agent-harness && pip install -e . # Use from anywhere cli-anything-gimp --help cli-anything-gimp project new --width 1920 --height 1080 -o poster.json cli-anything-gimp --json layer add -n "Background" --type solid --color "#1a1a2e" # Enter interactive REPL cli-anything-gimp ``` Each installed CLI ships with a [`SKILL.md`](#-skillmd-generation) inside the Python package (`cli_anything//skills/SKILL.md`). The REPL banner automatically displays the absolute path to this file so AI agents know exactly where to read the skill definition. No extra configuration needed โ€” `pip install` makes the skill discoverable. --- ## ๐Ÿค– Empower Your Agents with CLI-Hub CLI-Hub lets agents autonomously discover and install the CLIs they need โ€” zero human intervention required. We published a **meta-skill** that lets any AI agent freely explore the full catalog of community CLIs and pick the right one for the task. **Install in one command:** ```bash # OpenClaw openclaw skills install cli-anything-hub # nanobot nanobot skills install cli-anything-hub ``` **Then just prompt your agent:** ``` Find appropriate CLI software in CLI-Hub and complete the task: ``` The agent will browse the catalog, install whichever CLI fits the task, and use it โ€” all autonomously. **How it works under the hood:** 1. The meta-skill points to the live catalog at [`https://hkuds.github.io/CLI-Anything/SKILL.txt`](https://hkuds.github.io/CLI-Anything/SKILL.txt) 2. The agent reads 20+ CLIs organized by category with one-line `pip install` commands 3. The agent installs whichever CLI fits the task, then reads that CLI's own SKILL.md for detailed usage The catalog auto-updates whenever `registry.json` changes โ€” new community CLIs show up automatically. > **For Claude Code users:** Copy [`cli-hub-meta-skill/SKILL.md`](cli-hub-meta-skill/SKILL.md) into your project or skills directory for the same automatic CLI discovery. --- ## ๐Ÿ’ก CLI-Anything's Vision: Building Agent-Native Software โ€ข ๐ŸŒ **Universal Access** - Every software becomes instantly agent-controllable through structured CLI. โ€ข ๐Ÿ”— **Seamless Integration** - Agents control any application without APIs, GUI, rebuilding or complex wrappers. โ€ข ๐Ÿš€ **Future-Ready Ecosystem** - Transform human-designed software into agent-native tools with one command. --- ## ๐Ÿ”ง When to Use CLI-Anything | Category | How to be Agent-native | Notable Examples | |----------|----------------------|----------| | **๐Ÿ“‚ GitHub Repositories** | Transform any open-source project into agent-controllable tools through automatic CLI generation | VSCodium, WordPress, Calibre, Zotero, Joplin, Logseq, Penpot, Super Productivity | | **๐Ÿค– AI/ML Platforms** | Automate model training, inference pipelines, and hyperparameter tuning through structured commands | Stable Diffusion WebUI, ComfyUI, Ollama, InvokeAI, Text-generation-webui, Open WebUI, Fooocus, Kohya_ss, AnythingLLM, SillyTavern | | **๐Ÿ“Š Data & Analytics** | Enable programmatic data processing, visualization, and statistical analysis workflows | JupyterLab, Apache Superset, Metabase, Redash, DBeaver, KNIME, Orange, OpenSearch Dashboards, Lightdash | | **๐Ÿ’ป Development Tools** | Streamline code editing, building, testing, and deployment processes via command interfaces | Jenkins, Gitea, Hoppscotch, Portainer, pgAdmin, SonarQube, ArgoCD, OpenLens, Insomnia, Beekeeper Studio, **[iTerm2](https://iterm2.com)** | | **๐ŸŽจ Creative & Media** | Control content creation, editing, and rendering workflows programmatically | Blender, GIMP, OBS Studio, Audacity, Krita, Kdenlive, Shotcut, Inkscape, Darktable, LMMS, Ardour | | **๐Ÿ”ฌ Scientific Computing** | Automate research workflows, simulations, and complex calculations | ImageJ, FreeCAD, QGIS, ParaView, Gephi, LibreCAD, Stellarium, KiCad, JASP, Jamovi | | **๐Ÿข Enterprise & Office** | Convert business applications and productivity tools into agent-accessible systems | NextCloud, GitLab, Grafana, Mattermost, LibreOffice, AppFlowy, NocoDB, Odoo (Community), Plane, ERPNext | | **๐Ÿ“ž Communication & Collaboration** | Automate meeting scheduling, participant management, recording retrieval, and reporting through structured CLI | Zoom, Jitsi Meet, BigBlueButton, Mattermost | | **๐Ÿ“ Diagramming & Visualization** | Create and manipulate diagrams, flowcharts, architecture diagrams, and visual documentation programmatically | Draw.io (diagrams.net), Mermaid, PlantUML, Excalidraw, yEd | | **๐ŸŒ Network & Infrastructure** | Manage network services, DNS, ad-blocking, and infrastructure through structured CLI commands | AdGuardHome | | **๐Ÿ”ฌ Graphics & GPU Debugging** | Analyze GPU frame captures, inspect pipeline state, export shaders, and diff rendering state | RenderDoc | | **โœจ AI Content Generation** | Generate professional deliverables (slides, docs, diagrams, websites, research reports) through AI-powered cloud APIs | [AnyGen](https://www.anygen.io), Gamma, Beautiful.ai, Tome | --- ## CLI-Anything's Key Features ### The Agent-Software Gap AI agents are great at reasoning but terrible at using real professional software. Current solutions are fragile UI automation, limited APIs, or dumbed-down reimplementations that miss 90% of functionality. **CLI-Anything's Solution**: Transform any professional software into agent-native tools without losing capabilities. | **Current Pain Point** | **CLI-Anything's Fix** | |----------|----------------------| | ๐Ÿค– "AI can't use real tools" | Direct integration with actual software backends (Blender, LibreOffice, FFmpeg) โ€” full professional capabilities, zero compromises | | ๐Ÿ’ธ "UI automation breaks constantly" | No screenshots, no clicking, no RPA fragility. Pure command-line reliability with structured interfaces | | ๐Ÿ“Š "Agents need structured data" | Built-in JSON output for seamless agent consumption + human-readable formats for debugging | | ๐Ÿ”ง "Custom integrations are expensive" | One Claude plugin auto-generates CLIs for ANY codebase through proven 7-phase pipeline | | โšก "Prototype vs Production gap" | 1,839+ tests with real software validation. Battle-tested across 16 major applications | --- ## ๐ŸŽฏ What Can You Do with CLI-Anything?
### ๐Ÿ› ๏ธ Let Agents Take Your Workflows Professional or everyday โ€” just throw the codebase at `/cli-anything`. GIMP, Blender, Shotcut for creative work. LibreOffice, OBS Studio for daily tasks. Don't have the source? Find an open-source alternative and throw *that* in. You'll instantly get a full CLI your agents can use. ### ๐Ÿ”— Unify Scattered APIs into One CLI Tired of juggling fragmented web service APIs? Feed the docs or SDK manuscripts to `/cli-anything` and your agents get a **powerful, stateful CLI** that wraps those individual endpoints into coherent command groups. One tool instead of dozens of raw API calls โ€” stronger capabilities while saving tokens. ### ๐Ÿš€ Replace or Supercharge GUI Agents CLI-Anything can flat-out **replace GUI-based agent approaches** โ€” no more screenshots, no brittle pixel-clicking. But here's the fun part: once you `/cli-anything` a GUI software, you can **synthesize agent tasks, evaluators, and benchmarks** entirely via code and terminal โ€” fully automated, iteratively refinable, massively more efficient.
--- ## โœจ โš™๏ธ How CLI-Anything Works
### ๐Ÿ—๏ธ Fully Automated 7-Phase Pipeline From codebase analysis to PyPI publishing โ€” the plugin handles architecture design, implementation, test planning, test writing, and documentation completely automatically. ### ๐ŸŽฏ Authentic Software Integration Direct calls to real applications for actual rendering. LibreOffice generates PDFs, Blender renders 3D scenes, Audacity processes audio via sox. **Zero compromises**, **Zero toy implementations**.
### ๐Ÿ” Smart Session Management Persistent project state with undo/redo capabilities, plus unified REPL interface (ReplSkin) that delivers consistent interactive experience across all CLIs. ### ๐Ÿ“ฆ Zero-Config Installation Simple pip install -e . puts cli-anything- directly on PATH. Agents discover tools via standard which commands. No setup, no wrappers.
### ๐Ÿงช Production-Grade Testing Multi-layered validation: unit tests with synthetic data, end-to-end tests with real files and software, plus CLI subprocess verification of installed commands. ### ๐Ÿ Clean Package Architecture All CLIs organized under cli_anything.* namespace โ€” conflict-free, pip-installable, with consistent naming: cli-anything-gimp, cli-anything-blender, etc.
### ๐Ÿค– SKILL.md Generation Each generated CLI includes a `SKILL.md` file inside the Python package at `cli_anything//skills/SKILL.md`. This self-contained skill definition enables AI agents to discover and use the CLI through Claude Code's skill system or other agent frameworks. **What SKILL.md provides:** - **YAML frontmatter** with name and description for agent skill discovery - **Command groups** with all available subcommands documented - **Usage examples** for common workflows - **Agent-specific guidance** for JSON output, error handling, and programmatic use SKILL.md files are auto-generated during Phase 6.5 of the pipeline using `skill_generator.py`, which extracts metadata directly from the CLI's Click decorators, setup.py, and README. Because the file lives inside the package, it is installed alongside the CLI via `pip install` and auto-detected by the REPL banner โ€” agents can read the absolute path displayed at startup. --- ## ๐ŸŽฌ Demonstrations ### ๐ŸŽฏ General-Purpose CLI-Anything works on any software with a codebase โ€” no domain restrictions or architectural limitations. ### ๐Ÿญ Professional-Grade Testing Tested across 16 diverse, complex applications spanning creative, productivity, communication, diagramming, AI image generation, AI content generation, network ad blocking, and local LLM inference domains previously inaccessible to AI agents. ### ๐ŸŽจ Diverse Domain Coverage From creative workflows (image editing, 3D modeling, vector graphics) to production tools (audio, office, live streaming, video editing). ### โœ… Full CLI Generation Each application received complete, production-ready CLI interfaces โ€” not demos, but comprehensive tool access preserving full capabilities.
Software Domain CLI Command Backend Tests
๐ŸŽจ GIMP Image Editing cli-anything-gimp Pillow + GEGL/Script-Fu โœ… 107
๐ŸงŠ Blender 3D Modeling & Rendering cli-anything-blender bpy (Python scripting) โœ… 208
โœ๏ธ Inkscape Vector Graphics cli-anything-inkscape Direct SVG/XML manipulation โœ… 202
๐ŸŽต Audacity Audio Production cli-anything-audacity Python wave + sox โœ… 161
๐ŸŒ Browser Browser Automation cli-anything-browser DOMShell MCP + Accessibility Tree โœ… New
๐Ÿ“„ LibreOffice Office Suite (Writer, Calc, Impress) cli-anything-libreoffice ODF generation + headless LO โœ… 158
๐Ÿ“ Mubu Knowledge Management & Outlining cli-anything-mubu Local Mubu data + sync logs โœ… 96
๐Ÿ“น OBS Studio Live Streaming & Recording cli-anything-obs-studio JSON scene + obs-websocket โœ… 153
๐ŸŽž๏ธ Kdenlive Video Editing cli-anything-kdenlive MLT XML + melt renderer โœ… 155
๐ŸŽฌ Shotcut Video Editing cli-anything-shotcut Direct MLT XML + melt โœ… 154
๐Ÿ“ž Zoom Video Conferencing cli-anything-zoom Zoom REST API (OAuth2) โœ… 22
๐ŸŽต MuseScore Music Notation cli-anything-musescore mscore CLI (MSCX/MusicXML) โœ… 56
๐Ÿ“ Draw.io Diagramming cli-anything-drawio mxGraph XML + draw.io CLI โœ… 138
๐Ÿงœ Mermaid Live Editor Diagramming cli-anything-mermaid Mermaid state + mermaid.ink renderer โœ… 10
โœจ AnyGen AI Content Generation cli-anything-anygen AnyGen REST API (anygen.io) โœ… 50
๐Ÿง  NotebookLM AI Research Assistant cli-anything-notebooklm NotebookLM CLI wrapper (experimental) โœ… 21
๐Ÿ–ผ๏ธ ComfyUI AI Image Generation cli-anything-comfyui ComfyUI REST API โœ… 70
๐Ÿ›ก๏ธ AdGuard Home Network-wide Ad Blocking cli-anything-adguardhome AdGuard Home REST API โœ… 36
๐Ÿฆ™ Ollama Local LLM Inference cli-anything-ollama Ollama REST API โœ… 98
๐ŸŽจ Sketch UI Design sketch-cli sketch-constructor (Node.js) โœ… 19
Total โœ… 1,858
> **100% pass rate** across all 1,858 tests โ€” 1,355 unit tests + 484 end-to-end tests + 19 Node.js tests. --- ## ๐Ÿ“Š Test Results Each CLI harness undergoes rigorous multi-layered testing to ensure production reliability: | Layer | What it tests | Example | |-------|---------------|---------| | **Unit tests** | Every core function in isolation with synthetic data | `test_core.py` โ€” project creation, layer ops, filter params | | **E2E tests (native)** | Project file generation pipeline | Valid ODF ZIP structure, correct MLT XML, SVG well-formedness | | **E2E tests (true backend)** | Real software invocation + output verification | LibreOffice โ†’ PDF with `%PDF-` magic bytes, Blender โ†’ rendered PNG | | **CLI subprocess tests** | Installed command via `subprocess.run` | `cli-anything-gimp --json project new` โ†’ valid JSON output | ``` ================================ Test Summary ================================ gimp 107 passed โœ… (64 unit + 43 e2e) blender 208 passed โœ… (150 unit + 58 e2e) inkscape 202 passed โœ… (148 unit + 54 e2e) audacity 161 passed โœ… (107 unit + 54 e2e) libreoffice 158 passed โœ… (89 unit + 69 e2e) mubu 96 passed โœ… (85 unit + 11 e2e) obs-studio 153 passed โœ… (116 unit + 37 e2e) kdenlive 155 passed โœ… (111 unit + 44 e2e) shotcut 154 passed โœ… (110 unit + 44 e2e) zoom 22 passed โœ… (22 unit + 0 e2e) drawio 138 passed โœ… (116 unit + 22 e2e) mermaid 10 passed โœ… (5 unit + 5 e2e) anygen 50 passed โœ… (40 unit + 10 e2e) notebooklm 21 passed โœ… (21 unit + 0 e2e) comfyui 70 passed โœ… (60 unit + 10 e2e) adguardhome 36 passed โœ… (24 unit + 12 e2e) ollama 98 passed โœ… (87 unit + 11 e2e) sketch 19 passed โœ… (19 jest, Node.js) renderdoc 59 passed โœ… (45 unit + 14 e2e) โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ TOTAL 1,917 passed โœ… 100% pass rate ``` --- ## ๐Ÿ—๏ธ CLI-Anything's Architecture

CLI-Anything Architecture

### ๐ŸŽฏ Core Design Principles 1. **Authentic Software Integration** โ€” The CLI generates valid project files (ODF, MLT XML, SVG) and delegates to real applications for rendering. **We build structured interfaces TO software, not replacements**. 2. **Flexible Interaction Models** โ€” Every CLI operates in dual modes: stateful REPL for interactive agent sessions + subcommand interface for scripting/pipelines. **Run bare command โ†’ enter REPL mode**. 3. **Consistent User Experience** โ€” All generated CLIs share unified REPL interface (repl_skin.py) with branded banners, styled prompts, command history, progress indicators, and standardized formatting. 4. **Agent-Native Design** โ€” Built-in --json flag on every command delivers structured data for machine consumption, while human-readable tables serve interactive use. **Agents discover capabilities via standard --help and which commands**. 5. **Zero Compromise Dependencies** โ€” Real software is a hard requirement โ€” no fallbacks, no graceful degradation. **Tests fail (not skip) when backends are missing, ensuring authentic functionality**. --- ## ๐Ÿ“‚ Project Structure ``` cli-anything/ โ”œโ”€โ”€ ๐Ÿ“„ README.md # You are here โ”œโ”€โ”€ ๐Ÿ“ assets/ # Images and media โ”‚ โ”œโ”€โ”€ icon.png # Project icon โ”‚ โ””โ”€โ”€ teaser.png # Teaser figure โ”‚ โ”œโ”€โ”€ ๐Ÿ”Œ cli-anything-plugin/ # The Claude Code plugin โ”‚ โ”œโ”€โ”€ HARNESS.md # Methodology SOP (source of truth) โ”‚ โ”œโ”€โ”€ README.md # Plugin documentation โ”‚ โ”œโ”€โ”€ QUICKSTART.md # 5-minute getting started โ”‚ โ”œโ”€โ”€ PUBLISHING.md # Distribution guide โ”‚ โ”œโ”€โ”€ repl_skin.py # Unified REPL interface โ”‚ โ”œโ”€โ”€ commands/ # Plugin command definitions โ”‚ โ”‚ โ”œโ”€โ”€ cli-anything.md # Main build command โ”‚ โ”‚ โ”œโ”€โ”€ refine.md # Expand existing harness coverage โ”‚ โ”‚ โ”œโ”€โ”€ test.md # Test runner โ”‚ โ”‚ โ””โ”€โ”€ validate.md # Standards validation โ”‚ โ””โ”€โ”€ scripts/ โ”‚ โ””โ”€โ”€ setup-cli-anything.sh # Setup script โ”‚ โ”œโ”€โ”€ ๐Ÿค– codex-skill/ # Codex skill entry point โ”œโ”€โ”€ ๐ŸŽจ gimp/agent-harness/ # GIMP CLI (107 tests) โ”œโ”€โ”€ ๐ŸงŠ blender/agent-harness/ # Blender CLI (208 tests) โ”œโ”€โ”€ โœ๏ธ inkscape/agent-harness/ # Inkscape CLI (202 tests) โ”œโ”€โ”€ ๐ŸŽต audacity/agent-harness/ # Audacity CLI (161 tests) โ”œโ”€โ”€ ๐ŸŒ browser/agent-harness/ # Browser CLI (DOMShell MCP, new) โ”œโ”€โ”€ ๐Ÿ“„ libreoffice/agent-harness/ # LibreOffice CLI (158 tests) โ”œโ”€โ”€ ๐Ÿ“ mubu/agent-harness/ # Mubu CLI (96 tests) โ”œโ”€โ”€ ๐Ÿ“น obs-studio/agent-harness/ # OBS Studio CLI (153 tests) โ”œโ”€โ”€ ๐ŸŽž๏ธ kdenlive/agent-harness/ # Kdenlive CLI (155 tests) โ”œโ”€โ”€ ๐ŸŽฌ shotcut/agent-harness/ # Shotcut CLI (154 tests) โ”œโ”€โ”€ ๐Ÿ“ž zoom/agent-harness/ # Zoom CLI (22 tests) โ”œโ”€โ”€ ๐ŸŽต musescore/agent-harness/ # MuseScore CLI (56 tests) โ”œโ”€โ”€ ๐Ÿ“ drawio/agent-harness/ # Draw.io CLI (138 tests) โ”œโ”€โ”€ ๐Ÿงœ mermaid/agent-harness/ # Mermaid Live Editor CLI (10 tests) โ”œโ”€โ”€ โœจ anygen/agent-harness/ # AnyGen CLI (50 tests) โ”œโ”€โ”€ ๐Ÿ–ผ๏ธ comfyui/agent-harness/ # ComfyUI CLI (70 tests) โ”œโ”€โ”€ ๐Ÿง  notebooklm/agent-harness/ # NotebookLM CLI (experimental, 21 tests) โ”œโ”€โ”€ ๐Ÿ›ก๏ธ adguardhome/agent-harness/ # AdGuard Home CLI (36 tests) โ”œโ”€โ”€ ๐Ÿฆ™ ollama/agent-harness/ # Ollama CLI (98 tests) โ”œโ”€โ”€ ๐ŸŽจ sketch/agent-harness/ # Sketch CLI (19 tests, Node.js) โ””โ”€โ”€ ๐Ÿ”ฌ renderdoc/agent-harness/ # RenderDoc CLI (59 tests) ``` Each `agent-harness/` contains an installable Python package under `cli_anything./` with Click CLI, core modules, utils (including `repl_skin.py` and backend wrapper), and comprehensive tests. --- ## ๐ŸŽฏ Plugin Commands | Command | Description | |---------|-------------| | `/cli-anything ` | Build complete CLI harness โ€” all 7 phases | | `/cli-anything:refine [focus]` | Refine an existing harness โ€” expand coverage with gap analysis | | `/cli-anything:test ` | Run tests and update TEST.md with results | | `/cli-anything:validate ` | Validate against HARNESS.md standards | ### Examples ```bash # Build a complete CLI for GIMP from local source /cli-anything /home/user/gimp # Build from a GitHub repo /cli-anything https://github.com/blender/blender # Refine an existing harness โ€” broad gap analysis /cli-anything:refine /home/user/gimp # Refine with a specific focus area /cli-anything:refine /home/user/shotcut "vid-in-vid and picture-in-picture compositing" # Run tests and update TEST.md /cli-anything:test /home/user/inkscape # Validate against HARNESS.md standards /cli-anything:validate /home/user/audacity ``` --- ## ๐ŸŽฎ Demo: Using a Generated CLI Here's what an agent can do with `cli-anything-libreoffice`: ```bash # Create a new Writer document $ cli-anything-libreoffice document new -o report.json --type writer โœ“ Created Writer document: report.json # Add content $ cli-anything-libreoffice --project report.json writer add-heading -t "Q1 Report" --level 1 โœ“ Added heading: "Q1 Report" $ cli-anything-libreoffice --project report.json writer add-table --rows 4 --cols 3 โœ“ Added 4ร—3 table # Export to real PDF via LibreOffice headless $ cli-anything-libreoffice --project report.json export render output.pdf -p pdf --overwrite โœ“ Exported: output.pdf (42,831 bytes) via libreoffice-headless # JSON mode for agent consumption $ cli-anything-libreoffice --json document info --project report.json { "name": "Q1 Report", "type": "writer", "pages": 1, "elements": 2, "modified": true } ``` ### REPL Mode ``` $ cli-anything-blender โ•”โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•— โ•‘ cli-anything-blender v1.0.0 โ•‘ โ•‘ Blender CLI for AI Agents โ•‘ โ•šโ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ• blender> scene new --name ProductShot โœ“ Created scene: ProductShot blender[ProductShot]> object add-mesh --type cube --location 0 0 1 โœ“ Added mesh: Cube at (0, 0, 1) blender[ProductShot]*> render execute --output render.png --engine CYCLES โœ“ Rendered: render.png (1920ร—1080, 2.3 MB) via blender --background blender[ProductShot]> exit Goodbye! ๐Ÿ‘‹ ``` --- ## ๐Ÿ“– The Standard Playbook: HARNESS.md HARNESS.md is our definitive SOP for making any software agent-accessible via automated CLI generation. It encodes proven patterns and methodologies refined through automated generation processes. The playbook distills key insights from successfully building all 16 diverse, production-ready harnesses. ### Critical Lessons | Lesson | Description | |--------|-------------| | **Use the real software** | The CLI MUST call the actual application for rendering. No Pillow replacements for GIMP, no custom renderers for Blender. Generate valid project files โ†’ invoke the real backend. | | **The Rendering Gap** | GUI apps apply effects at render time. If your CLI manipulates project files but uses a naive export tool, effects get silently dropped. Solution: native renderer โ†’ filter translation โ†’ render script. | | **Filter Translation** | When mapping effects between formats (MLT โ†’ ffmpeg), watch for duplicate filter merging, interleaved stream ordering, parameter space differences, and unmappable effects. | | **Timecode Precision** | Non-integer frame rates (29.97fps) cause cumulative rounding. Use `round()` not `int()`, integer arithmetic for display, and ยฑ1 frame tolerance in tests. | | **Output Verification** | Never trust that export worked because it exited 0. Verify: magic bytes, ZIP/OOXML structure, pixel analysis, audio RMS levels, duration checks. | > See the full methodology: [`cli-anything-plugin/HARNESS.md`](cli-anything-plugin/HARNESS.md) --- ## ๐Ÿ“ฆ Installation & Usage ### For Plugin Users (Claude Code) ```bash # Add marketplace & install (recommended) /plugin marketplace add HKUDS/CLI-Anything /plugin install cli-anything # Build a CLI for any software with a codebase /cli-anything ``` ### For Generated CLIs ```bash # Install any generated CLI cd /agent-harness pip install -e . # Verify which cli-anything- # Use cli-anything- --help cli-anything- # enters REPL cli-anything- --json # JSON output for agents ``` ### Running Tests ```bash # Run tests for a specific CLI cd /agent-harness python3 -m pytest cli_anything//tests/ -v # Force-installed mode (recommended for validation) CLI_ANYTHING_FORCE_INSTALLED=1 python3 -m pytest cli_anything//tests/ -v -s ``` --- ## ๐Ÿค Contributing We welcome contributions! CLI-Anything is designed to be extensible: - **New software targets** โ€” Use the plugin to generate a CLI for any software with a codebase, then submit your harness via [`cli-anything-plugin/PUBLISHING.md`](cli-anything-plugin/PUBLISHING.md). - **Methodology improvements** โ€” PRs to `HARNESS.md` that encode new lessons learned - **Plugin enhancements** โ€” New commands, phase improvements, better validation - **Test coverage** โ€” More E2E scenarios, edge cases, workflow tests ### Limitations - **Requires strong foundation models** โ€” CLI-Anything relies on frontier-class models (e.g., Claude Opus 4.6, Claude Sonnet 4.6, GPT-5.4) for reliable harness generation. Weaker or smaller models may produce incomplete or incorrect CLIs that require significant manual correction. - **Relies on available source code** โ€” The 7-phase pipeline analyzes and generates from source code. When the target software only provides compiled binaries that require decompilation, harness quality and coverage will degrade substantially. - **May require iterative refinement** โ€” A single `/cli-anything` run may not fully cover all capabilities. Running `/refine` one or more times is often needed to push the CLI's performance and coverage to production quality. ### Roadmap - [ ] Support for more application categories (CAD, DAW, IDE, EDA, scientific tools) - [ ] Benchmark suite for agent task completion rates - [ ] Community-contributed CLI harnesses for internal/custom software - [ ] Integration with additional agent frameworks beyond Claude Code - [ ] Support packaging APIs for closed-source software and web services into CLIs - [x] Produce SKILL.md alongside the CLI for agent skill discovery and orchestration --- ## ๐Ÿ“– Documentation | Document | Description | |----------|-------------| | [`cli-anything-plugin/HARNESS.md`](cli-anything-plugin/HARNESS.md) | The methodology SOP โ€” single source of truth | | [`cli-anything-plugin/README.md`](cli-anything-plugin/README.md) | Plugin documentation โ€” commands, options, phases | | [`cli-anything-plugin/QUICKSTART.md`](cli-anything-plugin/QUICKSTART.md) | 5-minute getting started guide | | [`cli-anything-plugin/PUBLISHING.md`](cli-anything-plugin/PUBLISHING.md) | Distribution and publishing guide | Each generated harness also includes: - `.md` โ€” Architecture SOP specific to that application - `tests/TEST.md` โ€” Test plan and results documentation --- ## โญ Star History If CLI-Anything helps make your software Agent-native, give us a star! โญ --- ## ๐Ÿ“„ License MIT License โ€” free to use, modify, and distribute. ---
**CLI-Anything** โ€” *Make any software with a codebase Agent-native.* A methodology for the age of AI agents | 16 professional software demos | 1,839 passing tests
CLI-Anything Icon

Thanks for visiting โœจ CLI-Anything!

Views