"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/
Python
Move AnyGen to standalone AI Content Generation category
yuzaifu05ae017e6f9d
diff --git a/README.md b/README.mdindex 5efabfb27..267ffb5ea 100644--- a/README.md+++ b/README.md@@ -1,26 +1,6 @@<h1 align="center"><img src="assets/icon.png" alt="" width="64" style="vertical-align: middle;"> CLI-Anything: Making ALL Software Agent-Native</h1>-<p align="center">- <strong>Today's Software Serves Humansπ¨βπ». Tomorrow's Users will be Agentsπ€.<br>-CLI-Anything: Bridging the Gap Between AI Agents and the World's Software</strong><br>-</p>--<p align="center">- <a href="#-quick-start"><img src="https://img.shields.io/badge/Quick_Start-5_min-blue?style=for-the-badge" alt="Quick Start"></a>- <a href="#-demonstrations"><img src="https://img.shields.io/badge/Demos-9_Apps-green?style=for-the-badge" alt="Demos"></a>- <a href="#-test-results"><img src="https://img.shields.io/badge/Tests-1%2C361_Passing-brightgreen?style=for-the-badge" alt="Tests"></a>- <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow?style=for-the-badge" alt="License"></a>-</p>-<p align="center">- <img src="https://img.shields.io/badge/python-β₯3.10-blue?logo=python&logoColor=white" alt="Python">- <img src="https://img.shields.io/badge/click-β₯8.0-green" alt="Click">- <img src="https://img.shields.io/badge/pytest-100%25_pass-brightgreen" alt="Pytest">- <img src="https://img.shields.io/badge/coverage-unit_%2B_e2e-orange" alt="Coverage">- <img src="https://img.shields.io/badge/output-JSON_%2B_Human-blueviolet" alt="Output">- <a href="https://github.com/HKUDS/.github/blob/main/profile/README.md"><img src="https://img.shields.io/badge/Feishu-Group-E9DBFC?style=flat&logo=feishu&logoColor=white" alt="Feishu"></a>-<a href="https://github.com/HKUDS/.github/blob/main/profile/README.md"><img src="https://img.shields.io/badge/WeChat-Group-C5EAB4?style=flat&logo=wechat&logoColor=white" alt="WeChat"></a>-</p>**One Command Line**: Make any software agent-ready for OpenClaw, nanobot, Cursor, Claude Code, etc. [**δΈζζζ‘£**](README_CN.md)@@ -28,9 +8,6 @@ CLI-Anything: Bridging the Gap Between AI Agents and the World's Software</stron<img src="assets/cli-typing.gif" alt="CLI-Anything typing demo" width="800"></p>-<p align="center">- <img src="assets/teaser.png" alt="CLI-Anything Teaser" width="800">-</p>---@@ -85,6 +62,7 @@ That's it. The plugin is now available in your Claude Code session.```This runs the full pipeline:+1. π **Analyze** β Scans source code, maps GUI actions to APIs2. π **Design** β Architects command groups, state model, output formats3. π¨ **Implement** β Builds Click CLI with REPL, JSON output, undo/redo@@ -108,8 +86,7 @@ cli-anything-gimp --json layer add -n "Background" --type solid --color "#1a1a2ecli-anything-gimp```-<details>-<summary><strong>Alternative: Manual Installation</strong></summary>+**Alternative: Manual Installation**If you prefer not to use the marketplace:@@ -124,7 +101,7 @@ cp -r CLI-Anything/cli-anything-plugin ~/.claude/plugins/cli-anything/reload-plugins```-</details>+---@@ -146,9 +123,10 @@ cp -r CLI-Anything/cli-anything-plugin ~/.claude/plugins/cli-anything| **π€ AI/ML Platforms** | Automate model training, inference pipelines, and hyperparameter tuning through structured commands | Stable Diffusion WebUI, ComfyUI, 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 |-| **π¨ Creative & Media** | Control content creation, editing, and rendering workflows programmatically | Blender, GIMP, OBS Studio, Audacity, Krita, Kdenlive, Shotcut, Inkscape, Darktable, LMMS, Ardour, AnyGen |+| **π¨ 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 |+| **β¨ 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@@ -200,143 +178,81 @@ CLI-Anything can flat-out **replace GUI-based agent approaches** β no more scr## β¨ βοΈ How CLI-Anything Works-<table>-<tr>-<td width="50%">++| |+| --- |+| |+### ποΈ 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.-</td>-<td width="50%">+### π― 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**.-</td>-</tr>-<tr>-<td width="50%">+### π Smart Session Management+Persistent project state with undo/redo capabilities, plus unified REPL interface (ReplSkin) that delivers consistent interactive experience across all CLIs.-</td>-<td width="50%">+### π¦ Zero-Config Installation-Simple pip install -e . puts cli-anything-<software> directly on PATH. Agents discover tools via standard which commands. No setup, no wrappers.-</td>-</tr>-<tr>-<td width="50%">+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.-</td>-<td width="50%">+### π Clean Package Architecture+All CLIs organized under cli_anything.* namespace β conflict-free, pip-installable, with consistent naming: cli-anything-gimp, cli-anything-blender, etc.-</td>-</tr>-</table>+---## π¬ Demonstrations### π― General-Purpose+CLI-Anything works on any software with a codebase β no domain restrictions or architectural limitations.### π Professional-Grade TestingTested across 9 diverse, complex open-source applications spanning creative and productivity 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.-<table>-<tr>-<th align="center">Software</th>-<th align="center">Domain</th>-<th align="center">CLI Command</th>-<th align="center">Backend</th>-<th align="center">Tests</th>-</tr>-<tr>-<td align="center"><strong>π¨ GIMP</strong></td>-<td>Image Editing</td>-<td><code>cli-anything-gimp</code></td>-<td>Pillow + GEGL/Script-Fu</td>-<td align="center">β 107</td>-</tr>-<tr>-<td align="center"><strong>π§ Blender</strong></td>-<td>3D Modeling & Rendering</td>-<td><code>cli-anything-blender</code></td>-<td>bpy (Python scripting)</td>-<td align="center">β 208</td>-</tr>-<tr>-<td align="center"><strong>βοΈ Inkscape</strong></td>-<td>Vector Graphics</td>-<td><code>cli-anything-inkscape</code></td>-<td>Direct SVG/XML manipulation</td>-<td align="center">β 202</td>-</tr>-<tr>-<td align="center"><strong>π΅ Audacity</strong></td>-<td>Audio Production</td>-<td><code>cli-anything-audacity</code></td>-<td>Python wave + sox</td>-<td align="center">β 161</td>-</tr>-<tr>-<td align="center"><strong>π LibreOffice</strong></td>-<td>Office Suite (Writer, Calc, Impress)</td>-<td><code>cli-anything-libreoffice</code></td>-<td>ODF generation + headless LO</td>-<td align="center">β 158</td>-</tr>-<tr>-<td align="center"><strong>πΉ OBS Studio</strong></td>-<td>Live Streaming & Recording</td>-<td><code>cli-anything-obs-studio</code></td>-<td>JSON scene + obs-websocket</td>-<td align="center">β 153</td>-</tr>-<tr>-<td align="center"><strong>ποΈ Kdenlive</strong></td>-<td>Video Editing</td>-<td><code>cli-anything-kdenlive</code></td>-<td>MLT XML + melt renderer</td>-<td align="center">β 155</td>-</tr>-<tr>-<td align="center"><strong>π¬ Shotcut</strong></td>-<td>Video Editing</td>-<td><code>cli-anything-shotcut</code></td>-<td>Direct MLT XML + melt</td>-<td align="center">β 154</td>-</tr>-<tr>-<td align="center"><strong>β¨ AnyGen</strong></td>-<td>AI Content Generation</td>-<td><code>cli-anything-anygen</code></td>-<td>AnyGen OpenAPI (cloud)</td>-<td align="center">β 63</td>-</tr>-<tr>-<td align="center" colspan="4"><strong>Total</strong></td>-<td align="center"><strong>β 1,361</strong></td>-</tr>-</table>++| 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 |+| **π LibreOffice** | Office Suite (Writer, Calc, Impress) | `cli-anything-libreoffice` | ODF generation + headless LO | β 158 |+| **πΉ 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 |+| **β¨ AnyGen** | AI Content Generation | `cli-anything-anygen` | AnyGen OpenAPI (cloud) | β 63 |+| **Total** | **β 1,361** | | | |+> **100% pass rate** across all 1,361 tests β 940 unit tests + 421 end-to-end tests.@@ -346,12 +262,14 @@ Each application received complete, production-ready CLI interfaces β not demoEach 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 |++| 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 ================================@@ -372,20 +290,14 @@ TOTAL 1,361 passed β 100% pass rate## ποΈ CLI-Anything's Architecture-<p align="center">- <img src="assets/architecture.png" alt="CLI-Anything Architecture" width="750">-</p>+### π― Core Design Principles1. **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**.---@@ -430,12 +342,14 @@ Each `agent-harness/` contains an installable Python package under `cli_anything## π― Plugin Commands-| 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 |++| 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 |+### Examples@@ -526,15 +440,17 @@ The playbook distills key insights from successfully building all 8 diverse, pro### 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)+| 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)`---@@ -584,7 +500,7 @@ CLI_ANYTHING_FORCE_INSTALLED=1 python3 -m pytest cli_anything/<software>/tests/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).+- **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@@ -602,14 +518,17 @@ We welcome contributions! CLI-Anything is designed to be extensible:## π 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 |++| 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:+- `<SOFTWARE>.md` β Architecture SOP specific to that application- `tests/TEST.md` β Test plan and results documentation@@ -619,17 +538,7 @@ Each generated harness also includes:If CLI-Anything helps make your software Agent-native, give us a star! β-<!-- Uncomment when published:-<div align="center">- <a href="https://star-history.com/#HKUDS/CLI-Anything&Date">- <picture>- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=HKUDS/CLI-Anything&type=Date&theme=dark" />- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=HKUDS/CLI-Anything&type=Date" />- <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=HKUDS/CLI-Anything&type=Date" />- </picture>- </a>-</div>--->+---@@ -639,19 +548,18 @@ MIT License β free to use, modify, and distribute.----<div align="center">+**CLI-Anything** β *Make any software with a codebase Agent-native.*-<sub>A methodology for the age of AI agents | 9 professional software demos | 1,361 passing tests</sub>+A methodology for the age of AI agents | 9 professional software demos | 1,361 passing tests-<br>+-<img src="assets/icon.png" alt="CLI-Anything Icon" width="80">-</div>-<p align="center">- <em> Thanks for visiting β¨ CLI-Anything!</em><br><br>- <img src="https://visitor-badge.laobi.icu/badge?page_id=HKUDS.CLI-Anything&style=for-the-badge&color=00d4ff" alt="Views">-</p>++++*Thanks for visiting β¨ CLI-Anything!*+