CLI-Anything: Making ALL Software Agent-Native

_{README GIF generated from the full local demo video with a speed-adjusted, high-quality ffmpeg palette workflow.}

_{README GIF generated from the full local demo video with a speed-adjusted, high-quality ffmpeg palette workflow.}

Sub A	Sub B

_{README GIF generated from the full local demo video with a high-quality ffmpeg palette workflow.}

/` 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 18 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 CLI-Hub Users ```bash # Install the package manager pip install cli-anything-hub # Browse, search, inspect, and install CLIs cli-hub list cli-hub search cli-hub info cli-hub install # Manage installed CLIs cli-hub update cli-hub uninstall cli-hub launch [args...] ``` ### 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! ⭐

--- ## 📚 Citation If you find CLI-Anything useful, please cite our technical report: ```bibtex @misc{yang2026clianythingagentnativecomputeruse, title={CLI-Anything: Towards Agent-Native Computer Use}, author={Yuhao Yang and Tianyu Fan and Chao Huang}, year={2026}, eprint={2606.03854}, archivePrefix={arXiv}, primaryClass={cs.HC}, url={https://arxiv.org/abs/2606.03854}, } ``` --- ## 📄 License Apache License 2.0 — free to use, modify, and distribute. ---

**CLI-Anything** — *Make any software with a codebase Agent-native.* _{A methodology for the age of AI agents | 18 professional software demos | 2,280 passing tests}

Thanks for visiting ✨ CLI-Anything!