HKUDS/CLI-Anything

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/HKUDS/CLI-Anything.svg?style=card)](https://bestofgithub.dev/repo/HKUDS/CLI-Anything)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/HKUDS/CLI-Anything.svg)](https://bestofgithub.dev/repo/HKUDS/CLI-Anything)

Loading README…

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.

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

Command	Description
`/cli-anything <path-or-repo>`	Build a complete CLI harness
`/cli-anything:refine <path> [focus]`	Refine an existing CLI harness
`/cli-anything:test <path-or-repo>`	Run tests for a CLI harness
`/cli-anything:validate <path-or-repo>`	Validate a CLI harness
`/cli-anything:list [options]`	List all CLI-Anything tools

Track	Purpose	Install
Generator	Build new harnesses with `/cli-anything` (and refine/test/validate/list)	Cursor plugin in `cursor-plugin/`
Consumer	Find/install/use published CLIs from CLI-Hub	`npx skills` + `cli-hub` (unchanged)

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
🎨 Creative & Media	Control content creation, editing, and rendering workflows programmatically	Blender, GIMP, OBS Studio, Audacity, WaveTone, Krita, Kdenlive, Shotcut, Inkscape, Darktable, LMMS, Ardour
🎮 Game Development	Manage game projects, scenes, exports, and scripting through headless engine interfaces	Godot Engine, s&box
🔬 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
🧪 Testing & Mocking	Control HTTP mock servers, manage test stubs, record and replay API traffic for integration testing	WireMock
🔬 Graphics & GPU Debugging	Analyze GPU frame captures, inspect pipeline state, export shaders, and diff rendering state	RenderDoc
⚙️ Fabrication & Machine Control	Drive real hardware from design file to physical output — safety-gated detect, preflight, jog, and framing commands with machine profiles over the software's real backend	MeerK40t (laser), Ink/Stitch (embroidery)
🎬 Video & Subtitles	Transcribe speech, translate subtitles, burn styled captions into video — full captioning pipeline	VideoCaptioner
🔍 AI-Native Search	Neural and deep web search with structured content retrieval through embedding-based APIs	Exa
✨ AI Content Generation	Generate professional deliverables (slides, docs, diagrams, websites, research reports) through AI-powered cloud APIs	AnyGen, Gamma, Beautiful.ai, Tome

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"	2,280+ tests with real software validation. Battle-tested across 18 major applications

🏗️ 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.

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
WaveTone	Audio Transcription	`cli-anything-wavetone`	JSON manifest + real WaveTone launch	New
🌐 Browser	Browser Automation	`cli-anything-browser`	DOMShell MCP + Accessibility Tree	✅ New
Web Yu-pri	Japan Post Shipping Labels	`cli-anything-web-yu-pri`	Playwright + Web Yu-pri forms	✅ New
📄 LibreOffice	Office Suite (Writer, Calc, Impress)	`cli-anything-libreoffice`	ODF generation + headless LO	✅ 158
OpenRefine	Data Cleaning	`cli-anything-openrefine`	OpenRefine local HTTP API	✅ 76
⚡ n8n	Workflow Automation	`cli-anything-n8n`	n8n REST API v1.1.1	✅ 55+ cmds
📧 Mailchimp	Email Marketing & Automation	`cli-anything-mailchimp`	Mailchimp Marketing API v3.0	✅ 303 cmds
📚 Zotero	Reference Management	`cli-anything-zotero`	Local SQLite + connector + Local API	✅ New
📖 Calibre	E-book Library Management	`cli-anything-calibre`	calibredb + ebook-convert + ebook-meta	✅ 58
📓 Joplin	Note-taking & To-dos	`cli-anything-joplin`	Joplin terminal CLI subprocess	✅ 134
📝 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
📱 NSLogger	iOS/macOS Log Capture	`cli-anything-nslogger`	NSLogger wire protocol + native macOS Bonjour	✅ 139
🎞️ Kdenlive	Video Editing	`cli-anything-kdenlive`	MLT XML + melt renderer	✅ 155
🎬 Shotcut	Video Editing	`cli-anything-shotcut`	Direct MLT XML + melt	✅ 154
🎬 Openscreen	Screen Recording Editor	`cli-anything-openscreen`	ffmpeg backend	✅ 101
📞 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
EEZ Studio	Embedded UI / Instrument Automation	`cli-anything-eez-studio`	.eez-project JSON + EEZ Studio Node backend	✅ New
⛓️ ETH2 QuickStart	DevOps / Ethereum	`cli-anything-eth2-quickstart`	eth2-quickstart shell automation + JSON health checks	✅ 18
🧜 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
🧩 Dify Workflow	Dify DSL Editing	`cli-anything-dify-workflow`	Wrapper around the open-source dify-workflow CLI	✅ 11
🖼️ 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
🧬 Uni-Mol Tools	Molecular Property Prediction (AI4S)	`cli-anything-unimol-tools`	Uni-Mol molecular ML backend	✅ 67
🎬 VideoCaptioner	AI Video Captioning	`cli-anything-videocaptioner`	videocaptioner CLI (PyPI)	✅ 26
🎨 Sketch	UI Design	`sketch-cli`	sketch-constructor (Node.js)	✅ 19
🎮 Godot Engine	Game Development	`cli-anything-godot`	Godot 4.x headless subprocess	✅ 24
📦 s&box	Game Development	`cli-anything-sbox`	Source 2 game engine - direct file I/O on .scene/.prefab/.vmat/.vsnd JSON	✅ 244
🐞 LLDB	Native Debugging	`cli-anything-lldb`	LLDB Python API	✅ 27
🟩 Nsight Graphics CLI	GPU Debugging & Profiling	`cli-anything-nsight-graphics`	Official ngfx / ngfx-capture orchestration + GPU Trace summary + replay analysis	✅ 51
🔍 Exa	AI-Native Web Search	`cli-anything-exa`	exa-py SDK	✅ 40
📈 Unreal Insights	Performance Profiling	`cli-anything-unrealinsights`	Background trace sessions + engine-matched UnrealInsights build + headless export	✅ 50
☁️ CloudAnalyzer	Point cloud / trajectory QA	`cli-anything-cloudanalyzer`	CloudAnalyzer (Python API)	✅ 14
🗺️ QGIS	Geospatial Analysis & Mapping	`cli-anything-qgis`	PyQGIS + qgis_process	✅ 22
🔩 3MF	Mesh geometry editor for 3D printing	`cli-anything-3mf`	numpy, scipy, trimesh	✅ 50
🗄️ Tigris	Object Storage (S3-compatible, global, no egress) — buckets, objects, snapshots, IAM, access keys	`cli-anything-tigris`	subprocess wrapping the official `tigris` CLI	✅ New
Total				✅ 2,461

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

Command	Description
`/cli-anything <software-path-or-repo>`	Build complete CLI harness — all 7 phases
`/cli-anything:refine <software-path> [focus]`	Refine an existing harness — expand coverage with gap analysis
`/cli-anything:test <software-path-or-repo>`	Run tests and update TEST.md with results
`/cli-anything:validate <software-path-or-repo>`	Validate against HARNESS.md standards

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.

Document	Description
`cli-anything-plugin/HARNESS.md`	The methodology SOP — single source of truth
`cli-anything-plugin/README.md`	Plugin documentation — commands, options, phases
`cli-anything-plugin/QUICKSTART.md`	5-minute getting started guide
`cli-anything-plugin/PUBLISHING.md`	Distribution and publishing guide

Sub A	Sub B

CLI-Anything: Making ALL Software Agent-Native

📰 News

🤔 Why CLI?

🚀 Quick Start

Pick Your Agent Platform

⚡ Claude Code

⚡ Pi Coding Agent

⚡ OpenCode (Experimental)

⚡ Goose (Desktop / CLI) Experimental Community

⚡ Qodercli Community

⚡ OpenClaw Community

⚡ Cursor

⚡ Codex Experimental Community

⚡ Hermes Experimental Community

⚡ Reasonix Experimental Community

⚡ GitHub Copilot CLI Community

🔮 More Platforms (Coming Soon)

Use the Generated CLI

🤖 Empower Your Agents with CLI-Hub

💡 CLI-Anything's Vision: Building Agent-Native Software

🔧 When to Use CLI-Anything

CLI-Anything's Key Features

The Agent-Software Gap

🎯 What Can You Do with CLI-Anything?

🛠️ Let Agents Take Your Workflows

🔗 Unify Scattered APIs into One CLI

🚀 Replace or Supercharge GUI Agents

✨ ⚙️ How CLI-Anything Works

🏗️ Fully Automated 7-Phase Pipeline

🎯 Authentic Software Integration

🔁 Smart Session Management

📦 Zero-Config Installation

🧪 Production-Grade Testing

🐍 Clean Package Architecture

🤖 SKILL.md Generation

🎬 Real-World Demos

FreeCAD — Curiosity Rover via Preview, Live Preview, and Trajectory

Blender — Orbital Relay Drone via Preview, Live Preview, and Trajectory

Draw.io — HTTPS Handshake Diagram

Slay the Spire II — Game Automation

VideoCaptioner — Auto-Generated Subtitles

ArcGIS Pro — Live Agent Cartography via the MCP Bridge

🎬 Demonstrations

🎯 General-Purpose

🏭 Professional-Grade Testing

🎨 Diverse Domain Coverage

✅ Full CLI Generation

📊 Test Results

🏗️ CLI-Anything's Architecture

🎯 Core Design Principles

📂 Project Structure

🎯 Plugin Commands

Examples

🎮 Demo: Using a Generated CLI

REPL Mode

📖 The Standard Playbook: HARNESS.md

Critical Lessons

📦 Installation & Usage

For CLI-Hub Users

For Plugin Users (Claude Code)

For Generated CLIs

Running Tests

🤝 Contributing

Limitations

Roadmap

📖 Documentation

⭐ Star History

📚 Citation

📄 License

⚡ Goose (Desktop / CLI) ^Experimental ^Community

⚡ Qodercli ^Community

⚡ OpenClaw ^Community

⚡ Codex ^Experimental ^Community

⚡ Hermes ^Experimental ^Community

⚡ Reasonix ^Experimental ^Community

⚡ GitHub Copilot CLI ^Community