"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/
Python
docs: add German translation (README_DE.md) and update language switchers
Martin Kleineadd7d528872
diff --git a/.gitignore b/.gitignoreindex b17f6696e..f5454bdf5 100644--- a/.gitignore+++ b/.gitignore@@ -272,6 +272,7 @@assets/gen_typing_gif.py!README_CN.md+!README_DE.md!opencode-commands/!/qoder-plugin/diff --git a/README.md b/README.mdindex e78918196..418a15147 100644--- a/README.md+++ b/README.md@@ -33,7 +33,7 @@ CLI-Anything: Bridging the Gap Between AI Agents and the World's Software</stron<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 Pi, OpenClaw, nanobot, Cursor, Claude Code, etc. [**中文文档**](README_CN.md) | [**日本語ドキュメント**](README_JA.md)+**One Command Line**: Make any software agent-ready for Pi, OpenClaw, nanobot, Cursor, Claude Code, etc. [**中文文档**](README_CN.md) | [**日本語ドキュメント**](README_JA.md) | [**Deutsch**](README_DE.md)<p align="center"><img src="assets/cli-typing.gif" alt="CLI-Anything typing demo" width="800">diff --git a/README_DE.md b/README_DE.mdnew file mode 100644index 000000000..041790bcb--- /dev/null+++ b/README_DE.md@@ -0,0 +1,892 @@+<h1 align="center"><img src="assets/icon.png" alt="" width="64" style="vertical-align: middle;"> CLI-Anything: Jede Software Agent-Native machen</h1>++<p align="center">+ <strong>Die Software von heute ist für Menschen👨💻. Die Nutzer von morgen sind Agenten🤖.<br>+CLI-Anything: Die Brücke zwischen KI-Agenten und der Software der Welt</strong><br>+</p>++**🌐 [CLI-Hub](https://hkuds.github.io/CLI-Anything/)**: Alle von der Community gebauten CLIs auf **[CLI-Hub](https://hkuds.github.io/CLI-Anything/)** entdecken — mit einem Befehl installieren. Du willst dein eigenes CLI beitragen? [PR einreichen](https://github.com/HKUDS/CLI-Anything/blob/main/CONTRIBUTING.md) — der Hub aktualisiert sich sofort.++<p align="center">+ <a href="#-schnellstart"><img src="https://img.shields.io/badge/Quick_Start-5_min-blue?style=for-the-badge" alt="Schnellstart"></a>+ <a href="#-demonstrationen"><img src="https://img.shields.io/badge/Demos-12_Apps-green?style=for-the-badge" alt="Demos"></a>+ <a href="#-testergebnisse"><img src="https://img.shields.io/badge/Tests-1%2C540_Passing-brightgreen?style=for-the-badge" alt="Tests"></a>+ <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-yellow?style=for-the-badge" alt="Lizenz"></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>++**Ein Befehl**: Mache jede Software agent-bereit für Pi, OpenClaw, nanobot, Cursor, Claude Code usw. [**English**](README.md) | [**中文文档**](README_CN.md) | [**日本語ドキュメント**](README_JA.md)++<p align="center">+ <img src="assets/cli-typing.gif" alt="CLI-Anything Tipp-Demo" width="800">+</p>++<p align="center">+ <img src="assets/teaser.png" alt="CLI-Anything Teaser" width="800">+</p>++---++## 🤔 Warum CLI?++Die Kommandozeile ist die universelle Schnittstelle — gleichermaßen für Menschen und KI-Agenten:++• **Strukturiert & komponierbar** — Textbefehle passen perfekt zum Ausgabeformat von LLMs und lassen sich zu komplexen Workflows verketten++• **Leichtgewichtig & universell** — minimaler Overhead, läuft auf jedem System ohne Abhängigkeiten++• **Selbsterklärend** — der `--help`-Flag liefert automatische, vom Agenten entdeckbare Dokumentation++• **Bewährt im Einsatz** — Claude Code führt täglich Tausende reale Workflows über CLIs aus++• **Agent-First-Design** — strukturierte JSON-Ausgaben ersparen jedes Parser-Theater++• **Deterministisch & zuverlässig** — konsistente Ergebnisse machen das Verhalten des Agenten vorhersehbar++## 🚀 Schnellstart++### Voraussetzungen++- **Python 3.10+**+- Die Zielsoftware muss installiert sein (z. B. GIMP, Blender, LibreOffice oder deine eigene Anwendung)+- Unterstützte KI-Coding-Agenten: [Claude Code](#-claude-code) | [OpenClaw](#-openclaw) | [OpenCode](#-opencode) | [Codex](#-codex) | [Qodercli](#-qodercli) | [GitHub Copilot CLI](#-github-copilot-cli) | [Weitere Plattformen](#-weitere-plattformen-bald)++### Wähle deine Plattform++<details open>+<summary><h4 id="-claude-code">⚡ Claude Code</h4></summary>++**Schritt 1: Marketplace hinzufügen**++CLI-Anything wird als Claude-Code-Plugin-Marketplace auf GitHub bereitgestellt.++```bash+# CLI-Anything-Marketplace hinzufügen+/plugin marketplace add HKUDS/CLI-Anything+```++**Schritt 2: Plugin installieren**++```bash+# cli-anything-Plugin aus dem Marketplace installieren+/plugin install cli-anything+```++Fertig. Das Plugin steht in deinen Claude-Code-Sessions zur Verfügung.++**Schritt 3: Mit einem Befehl ein CLI bauen**++```bash+# /cli-anything:cli-anything <Software-Pfad-oder-Repo>+# Komplettes CLI für GIMP generieren (alle 7 Phasen)+/cli-anything:cli-anything ./gimp++# Hinweis: bei Claude Code < 2.x stattdessen "/cli-anything" verwenden.+```++Das fährt die komplette Pipeline durch:+1. 🔍 **Analyse** — Source-Code scannen, GUI-Aktionen auf APIs mappen+2. 📐 **Design** — Befehlsgruppen, State-Modell und Ausgabeformate entwerfen+3. 🔨 **Implementierung** — Click-CLI mit REPL, JSON-Output, Undo/Redo bauen+4. 📋 **Testplan** — TEST.md mit Unit- und E2E-Testplan erstellen+5. 🧪 **Tests schreiben** — vollständige Test-Suite implementieren+6. 📝 **Dokumentation** — TEST.md mit Ergebnissen aktualisieren+7. 📦 **Veröffentlichung** — `setup.py` anlegen, ins PATH installieren++**Schritt 4 (optional): CLI verfeinern und erweitern**++Nach dem ersten Build lässt sich das CLI iterativ verfeinern — Abdeckung erweitern, fehlende Funktionen ergänzen:++```bash+# Breite Verfeinerung — der Agent analysiert Lücken über alle Funktionen+/cli-anything:refine ./gimp++# Fokussierte Verfeinerung — gezielt auf einen Funktionsbereich+/cli-anything:refine ./gimp "Ich möchte CLI-Unterstützung für Batch-Bildverarbeitung und Filter"+```++Der `refine`-Befehl macht eine Gap-Analyse zwischen vollständiger Software-Funktionalität und aktueller CLI-Abdeckung und implementiert neue Befehle, Tests und Doku für die gefundenen Lücken. Mehrfach ausführbar, um die Abdeckung schrittweise zu erweitern — jeder Lauf ist inkrementell und nicht-destruktiv.++<details>+<summary><strong>Alternative: manuelle Installation</strong></summary>++Wenn du den Marketplace nicht nutzen willst:++```bash+# Repo klonen+git clone https://github.com/HKUDS/CLI-Anything.git++# Plugin in das Plugin-Verzeichnis von Claude Code kopieren+cp -r CLI-Anything/cli-anything-plugin ~/.claude/plugins/cli-anything++# Plugins neu laden+/reload-plugins+```++</details>++</details>++<details>+<summary><h4 id="-opencode">⚡ OpenCode (experimentell)</h4></summary>++**Schritt 1: Commands installieren**++Kopiere die CLI-Anything-Commands **und** die `HARNESS.md` in das Command-Verzeichnis von OpenCode:++```bash+# Repo klonen+git clone https://github.com/HKUDS/CLI-Anything.git++# Globale Installation (in allen Projekten verfügbar)+cp CLI-Anything/opencode-commands/*.md ~/.config/opencode/commands/+cp CLI-Anything/cli-anything-plugin/HARNESS.md ~/.config/opencode/commands/++# Oder projektweite Installation+cp CLI-Anything/opencode-commands/*.md .opencode/commands/+cp CLI-Anything/cli-anything-plugin/HARNESS.md .opencode/commands/+```++> **Hinweis:** Die `HARNESS.md` ist die Methodik-Spezifikation, auf die alle Commands verweisen. Sie muss im selben Verzeichnis wie die Commands liegen.++Damit kommen fünf Slash-Commands hinzu: `/cli-anything`, `/cli-anything-refine`, `/cli-anything-test`, `/cli-anything-validate`, `/cli-anything-list`.++**Schritt 2: Mit einem Befehl ein CLI bauen**++```bash+# Komplettes CLI für GIMP generieren (alle 7 Phasen)+/cli-anything ./gimp++# Aus einem GitHub-Repo bauen+/cli-anything https://github.com/blender/blender+```++Die Commands laufen als Sub-Tasks und folgen derselben 7-Phasen-Methodik wie in Claude Code.++**Schritt 3 (optional): CLI verfeinern und erweitern**++```bash+# Breite Verfeinerung — der Agent analysiert Lücken über alle Funktionen+/cli-anything-refine ./gimp++# Fokussierte Verfeinerung — gezielt auf einen Funktionsbereich+/cli-anything-refine ./gimp "Batch-Verarbeitung und Filter"+```++</details>++<details>++<summary><h4 id="-qodercli">⚡ Qodercli <sup><code>Community</code></sup></h4></summary>++**Schritt 1: Plugin registrieren**++```bash+git clone https://github.com/HKUDS/CLI-Anything.git+bash CLI-Anything/qoder-plugin/setup-qodercli.sh+```++Damit wird das cli-anything-Plugin in `~/.qoder.json` eingetragen. Starte danach eine neue Qodercli-Session.++**Schritt 2: CLI-Anything aus Qodercli nutzen**++```bash+/cli-anything:cli-anything ./gimp+/cli-anything:refine ./gimp "Batch-Verarbeitung und Filter"+/cli-anything:validate ./gimp+```+</details>++<details>++<summary><h4 id="-openclaw">⚡ OpenClaw</h4></summary>++**Schritt 1: Skill installieren**++CLI-Anything stellt eine native OpenClaw-`SKILL.md` bereit. Kopiere sie in das Skill-Verzeichnis von OpenClaw:++```bash+# Repo klonen+git clone https://github.com/HKUDS/CLI-Anything.git++# In den globalen Skill-Ordner installieren+mkdir -p ~/.openclaw/skills/cli-anything+cp CLI-Anything/openclaw-skill/SKILL.md ~/.openclaw/skills/cli-anything/SKILL.md+```++**Schritt 2: CLI bauen**++Nach der Installation lässt sich der Skill in OpenClaw so aufrufen:++`@cli-anything build a CLI for ./gimp`++Der Skill folgt derselben 7-Phasen-Methodik wie Claude Code und OpenCode.++</details>++<details>++<summary><h4 id="-codex">⚡ Codex <sup><code>experimentell</code></sup> <sup><code>Community</code></sup></h4></summary>++**Schritt 1: Skill installieren**++Mitgelieferten Installer ausführen:++```bash+# Repo klonen+git clone https://github.com/HKUDS/CLI-Anything.git++# Skill installieren+bash CLI-Anything/codex-skill/scripts/install.sh+```++Unter Windows PowerShell:++```powershell+.\CLI-Anything\codex-skill\scripts\install.ps1+```++Der Skill landet unter `$CODEX_HOME/skills/cli-anything` (bzw. `~/.codex/skills/cli-anything`, falls `CODEX_HOME` nicht gesetzt ist).++Starte Codex danach neu, damit der Skill erkannt wird.++**Schritt 2: CLI-Anything aus Codex nutzen**++Beschreibe deine Aufgabe in natürlicher Sprache. Zum Beispiel:++```text+Bau mir mit CLI-Anything ein Harness für ./gimp+Verfeinere mit CLI-Anything den Picture-in-Picture-Workflow für ./shotcut+Validiere ./libreoffice mit CLI-Anything+```++Der Codex-Skill wendet dieselbe Methodik an wie das Claude-Code-Plugin und die OpenCode-Commands; das Format der generierten Python-Harnesses bleibt unverändert.+</details>++<details>++<summary><h4 id="-github-copilot-cli">⚡ GitHub Copilot CLI <sup><code>Community</code></sup></h4></summary>++**Schritt 1: Plugin installieren**++```bash+git clone https://github.com/HKUDS/CLI-Anything.git+cd CLI-Anything+copilot plugin install ./cli-anything-plugin+```++Damit ist das CLI-Anything-Plugin im GitHub Copilot CLI installiert und in deinen Copilot-CLI-Sessions sofort verfügbar.++**Schritt 2: CLI-Anything aus dem GitHub Copilot CLI nutzen**++```bash+/cli-anything:cli-anything ./gimp+/cli-anything:refine ./gimp "Batch-Verarbeitung und Filter"+/cli-anything:validate ./gimp+```++</details>++<details>+<summary><h4 id="-weitere-plattformen-bald">🔮 Weitere Plattformen (bald)</h4></summary>++CLI-Anything ist plattformunabhängig konzipiert. Unterstützung für weitere KI-Coding-Agenten ist geplant:++- **Codex** — verfügbar über den mitgelieferten Skill in `codex-skill/`+- **Cursor** — bald+- **Windsurf** — bald+- **Dein Lieblingstool** — Beiträge willkommen! Eine Referenzimplementierung findest du im Verzeichnis `opencode-commands/`.++</details>++### Das generierte CLI nutzen++Egal auf welcher Plattform du es baust — die generierten CLIs funktionieren überall gleich:++```bash+# Ins PATH installieren+cd gimp/agent-harness && pip install -e .++# Von überall aufrufbar+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"++# In die interaktive REPL einsteigen+cli-anything-gimp+```++---++## 💡 Die Vision von CLI-Anything: Agent-Native Software bauen++• 🌐 **Universeller Zugang** — jede Software wird über strukturierte CLIs sofort agent-steuerbar.++• 🔗 **Nahtlose Integration** — Agenten steuern jede Anwendung ohne API-Akrobatik, GUI-Hacks, Umbauten oder fragile Wrapper.++• 🚀 **Zukunftsorientiertes Ökosystem** — ein Befehl verwandelt für Menschen gemachte Software in agent-native Werkzeuge.++---++## 🔧 Wann CLI-Anything nutzen?++| Kategorie | So wird es Agent-Native | Repräsentative Beispiele |+|----------|----------------------|----------|+| **📂 GitHub-Repositories** | Jedes Open-Source-Projekt mit automatischer CLI-Generierung in ein agent-steuerbares Tool verwandeln | VSCodium, WordPress, Calibre, Zotero, Joplin, Logseq, Penpot, Super Productivity |+| **🤖 AI/ML-Plattformen** | Mit strukturierten Befehlen Modell-Training, Inferenz-Pipelines und Hyperparameter-Tuning automatisieren | Stable Diffusion WebUI, ComfyUI, InvokeAI, Text-generation-webui, Open WebUI, Fooocus, Kohya_ss, AnythingLLM, SillyTavern |+| **📊 Daten & Analytics** | Programmatische Datenverarbeitung, Visualisierung und statistische Analyse-Workflows | JupyterLab, Apache Superset, Metabase, Redash, DBeaver, KNIME, Orange, OpenSearch Dashboards, Lightdash |+| **💻 Entwickler-Tools** | Code-Editor, Build, Test und Deployment-Prozesse über Command-Interfaces streamlinen | Jenkins, Gitea, Hoppscotch, Portainer, pgAdmin, SonarQube, ArgoCD, OpenLens, Insomnia, Beekeeper Studio |+| **🎨 Kreativ & Medien** | Content-Erstellung, Editing und Rendering-Workflows programmatisch steuern | Blender, GIMP, OBS Studio, Audacity, Krita, Kdenlive, Shotcut, Inkscape, Darktable, LMMS, Ardour |+| **🔬 Wissenschaftliches Rechnen** | Forschungs-Workflows, Simulationen und aufwendige Berechnungen automatisieren | ImageJ, FreeCAD, QGIS, ParaView, Gephi, LibreCAD, Stellarium, KiCad, JASP, Jamovi |+| **🏢 Enterprise & Office** | Business-Anwendungen und Produktivitäts-Tools in agent-zugängliche Systeme verwandeln | NextCloud, GitLab, Grafana, Mattermost, LibreOffice, AppFlowy, NocoDB, Odoo (Community), Plane, ERPNext |+| **📞 Kommunikation & Zusammenarbeit** | Mit strukturierten CLIs Meeting-Scheduling, Teilnehmer-Verwaltung, Aufzeichnungen und Reports automatisieren | Zoom, Jitsi Meet, BigBlueButton, Mattermost |+| **📐 Diagramme & Visualisierung** | Diagramme, Flowcharts, Architekturskizzen und visuelle Dokumente programmatisch erzeugen und bearbeiten | Draw.io (diagrams.net), Mermaid, PlantUML, Excalidraw, yEd |+| **✨ AI-Content-Generation** | Über AI-gestützte Cloud-APIs professionelle Artefakte erzeugen (Slides, Dokumente, Diagramme, Websites, Research Reports) | [AnyGen](https://www.anygen.io), Gamma, Beautiful.ai, Tome |++---++## Hauptmerkmale von CLI-Anything++### Die Lücke zwischen Agent und Software+KI-Agenten können hervorragend schlussfolgern, scheitern aber regelmäßig daran, professionelle Software wirklich zu bedienen. Aktuelle Ansätze sind entweder brüchige UI-Automation, eingeschränkte APIs oder vereinfachte Re-Implementierungen, die 90 % der Funktionen verlieren.++**Die Lösung von CLI-Anything**: Jede professionelle Software in ein agent-natives Werkzeug verwandeln — ohne Funktion einzubüßen.++| **Aktuelle Herausforderung** | **Lösung von CLI-Anything** |+|----------|----------------------|+| 🤖 „KI kann keine echten Tools bedienen" | Direkte Integration mit echten Software-Backends (Blender, LibreOffice, FFmpeg) — voller Funktionsumfang, null Kompromisse |+| 💸 „UI-Automation bricht ständig" | Keine Screenshots, keine Klicks, keine RPA-Fragilität. Reine, strukturierte Kommandozeilen-Zuverlässigkeit |+| 📊 „Agenten brauchen strukturierte Daten" | Eingebautes JSON-Output für nahtlose Agent-Nutzung + menschenlesbares Format zum Debuggen |+| 🔧 „Custom-Integrationen sind teuer" | Ein Claude-Plugin generiert über eine bewährte 7-Phasen-Pipeline automatisch ein CLI für beliebige Codebases |+| ⚡ „Lücke zwischen Prototyp und Produktion" | Über 1.508 Tests und Validierung gegen echte Software. Erprobt an 11 professionellen Anwendungen |++---++## 🎯 Was kannst du mit CLI-Anything machen?++<table>+<tr>+<td width="33%">++### 🛠️ Lass Agenten deine Workflows übernehmen++Egal ob professionell oder Alltag — gib einfach eine Codebase an `/cli-anything`. Für Kreatives: GIMP, Blender, Shotcut. Für den Alltag: LibreOffice, OBS Studio. Keine Quellen? Such eine Open-Source-Alternative und übergib die. Heraus kommt ein vollständiges, agent-taugliches CLI — sofort.++</td>+<td width="33%">++### 🔗 Verstreute APIs zu einem CLI bündeln++Genervt davon, fragmentierte Web-Service-APIs zu jonglieren? Gib die Doku oder das SDK-Manuskript an `/cli-anything`, und der Agent baut dir ein **leistungsstarkes, zustandsbehaftetes CLI**, das einzelne Endpoints zu kohärenten Befehlsgruppen verschmilzt. Statt Dutzenden API-Aufrufen ein Tool — token-sparender und schlagkräftiger zugleich.++</td>+<td width="33%">++### 🚀 GUI-Agenten ersetzen oder verstärken++CLI-Anything **ersetzt GUI-basierte Agenten komplett** — keine Screenshots, kein brüchiges Pixel-Klicken nötig. Noch spannender: Wenn du eine Software per `/cli-anything` durchläufst, kannst du allein mit Code und Terminal **Agent-Tasks, Evaluatoren und Benchmarks synthetisieren** — vollautomatisch, iterativ verbesserbar, deutlich effizienter.++</td>+</tr>+</table>++---++## ✨ ⚙️ So funktioniert CLI-Anything++<table>+<tr>+<td width="50%">++### 🏗️ Vollautomatische 7-Phasen-Pipeline+Von der Codebase-Analyse bis zur PyPI-Veröffentlichung — das Plugin erledigt Architektur-Design, Implementierung, Testplanung, Test-Schreiben und Dokumentation komplett automatisch.++</td>+<td width="50%">++### 🎯 Echte Software-Integration+Direkte Aufrufe in die tatsächliche Anwendung für echtes Rendering. LibreOffice erzeugt PDFs, Blender rendert 3D-Szenen, Audacity verarbeitet Audio über sox. **Null Kompromisse**, **keine Spielzeug-Implementierungen**.++</td>+</tr>+<tr>+<td width="50%">++### 🔁 Smartes Session-Management+Persistenter Projekt-State mit Undo/Redo und eine vereinheitlichte REPL-Oberfläche (ReplSkin) für ein konsistentes interaktives Erlebnis über alle CLIs hinweg.++</td>+<td width="50%">++### 📦 Installation ohne Konfiguration+Ein simples `pip install -e .` fügt `cli-anything-<software>` direkt zum PATH hinzu. Agenten finden die Tools über das Standard-`which`-Kommando. Kein Setup, kein Wrapper.++</td>+</tr>+<tr>+<td width="50%">++### 🧪 Tests auf Produktionsniveau+Mehrschichtige Validierung: Unit-Tests mit synthetischen Daten, End-to-End-Tests gegen echte Dateien und Software, plus CLI-Subprozess-Verifikation der installierten Befehle.++</td>+<td width="50%">++### 🐍 Saubere Paket-Architektur+Alle CLIs leben im `cli_anything.*`-Namespace — kein Konflikt, pip-installierbar, einheitliches Naming: `cli-anything-gimp`, `cli-anything-blender` usw.++</td>+</tr>+</table>++---++## 🎬 Demonstrationen++### 🎯 Universell einsetzbar+CLI-Anything funktioniert mit jeder Software, die eine Codebase hat — keine Domänen-Beschränkungen, keine Architektur-Einschränkungen.++### 🏭 Tests auf Professional-Niveau+Getestet an 12 vielfältigen, anspruchsvollen Anwendungen, die für KI-Agenten zuvor unzugänglich waren — von Kreativ-, Produktivitäts-, Kommunikations-, Diagramm- und AI-Content-Bereichen bis hin zu GPU-Debugging.++### 🎨 Breite Domänen-Abdeckung+Von Kreativ-Workflows (Bildbearbeitung, 3D-Modeling, Vektorgrafik) bis zu Produktionstools (Audio, Office, Live-Streaming, Video-Editing).++### ✅ Vollständige CLI-Generierung+Für jede Anwendung wird ein komplettes, produktionsreifes CLI-Interface erzeugt — keine Demo, sondern umfassender Tool-Zugriff, der den vollen Funktionsumfang erhält.++<table>+<tr>+<th align="center">Software</th>+<th align="center">Domäne</th>+<th align="center">CLI-Befehl</th>+<th align="center">Backend</th>+<th align="center">Tests</th>+</tr>+<tr>+<td align="center"><strong>🎨 GIMP</strong></td>+<td>Bildbearbeitung</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>Vektorgrafik</td>+<td><code>cli-anything-inkscape</code></td>+<td>Direkte SVG/XML-Manipulation</td>+<td align="center">✅ 202</td>+</tr>+<tr>+<td align="center"><strong>🎵 Audacity</strong></td>+<td>Audio-Produktion</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-Generierung + Headless-LO</td>+<td align="center">✅ 158</td>+</tr>+<tr>+<td align="center"><strong>📹 OBS Studio</strong></td>+<td>Live-Streaming & Aufnahme</td>+<td><code>cli-anything-obs-studio</code></td>+<td>JSON-Szenen + 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>Direktes MLT XML + melt</td>+<td align="center">✅ 154</td>+</tr>+<tr>+<td align="center"><strong>📞 Zoom</strong></td>+<td>Videokonferenzen</td>+<td><code>cli-anything-zoom</code></td>+<td>Zoom REST API (OAuth2)</td>+<td align="center">✅ 22</td>+</tr>+<tr>+<td align="center"><strong>📐 Draw.io</strong></td>+<td>Diagramme</td>+<td><code>cli-anything-drawio</code></td>+<td>mxGraph XML + draw.io CLI</td>+<td align="center">✅ 138</td>+</tr>+<tr>+<td align="center"><strong>✨ AnyGen</strong></td>+<td>AI-Content-Generation</td>+<td><code>cli-anything-anygen</code></td>+<td>AnyGen REST API (anygen.io)</td>+<td align="center">✅ 50</td>+</tr>+<tr>+<td align="center"><strong>🟩 <a href="nsight-graphics/agent-harness/">Nsight Graphics CLI</a></strong></td>+<td>GPU-Debugging & -Profiling</td>+<td><code>cli-anything-nsight-graphics</code></td>+<td>Offizielle ngfx-/ngfx-capture-Orchestrierung + GPU-Trace-Summary</td>+<td align="center">✅ 40</td>+</tr>+<tr>+<td align="center" colspan="4"><strong>Gesamt</strong></td>+<td align="center"><strong>✅ 1.547</strong></td>+</tr>+</table>++> **Alle 1.547 Tests grün — 100 %** — 1.108 Unit-Tests + 439 End-to-End-Tests.++---++## 📊 Testergebnisse++Jedes CLI-Harness durchläuft eine strenge, mehrschichtige Test-Pipeline für Produktions-Zuverlässigkeit:++| Schicht | Was getestet wird | Beispiel |+|-------|---------------|---------|+| **Unit-Tests** | Alle Kern-Funktionen isoliert, mit synthetischen Daten | `test_core.py` — Projekt erstellen, Layer-Operationen, Filter-Parameter |+| **E2E-Tests (nativ)** | Projektdatei-Generierungs-Pipelines | Gültige ODF-ZIP-Struktur, korrektes MLT-XML, wohlgeformtes SVG |+| **E2E-Tests (echtes Backend)** | Echte Software-Aufrufe + Output-Verifikation | LibreOffice → PDF mit `%PDF-`-Magic-Bytes, Blender → gerendertes PNG |+| **CLI-Subprozess-Tests** | Installierte Befehle via `subprocess.run` | `cli-anything-gimp --json project new` → gültiges JSON-Output |++```+================================ Test-Zusammenfassung ================================+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)+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)+anygen 50 passed ✅ (40 unit + 10 e2e)+nsight-graphics 40 passed ✅ (36 unit + 4 e2e)+──────────────────────────────────────────────────────────────────────────────+Gesamt 1.547 passed ✅ 100 % Pass-Rate+```++---++## 🏗️ Die Architektur von CLI-Anything++<p align="center">+ <img src="assets/architecture.png" alt="CLI-Anything-Architektur" width="750">+</p>++### 🎯 Zentrale Design-Prinzipien++1. **Echte Software-Integration** — CLIs erzeugen gültige Projektdateien (ODF, MLT XML, SVG) und delegieren das Rendering an die echte Anwendung. **Wir bauen strukturierte Schnittstellen zur Software, keinen Ersatz für sie**.++2. **Flexibles Interaktionsmodell** — alle CLIs laufen im Dual-Mode: zustandsbehaftete REPL für interaktive Agent-Sessions + Sub-Command-Interface für Scripting und Pipelines. **Befehl ohne Argumente ausführen → REPL-Modus**.++3. **Einheitliche User-Experience** — alle generierten CLIs teilen sich dieselbe REPL-Oberfläche (`repl_skin.py`) mit Brand-Banner, gestaltetem Prompt, Command-History, Fortschrittsanzeigen und standardisiertem Formatting.++4. **Agent-Native Design** — jeder Befehl hat einen eingebauten `--json`-Flag für maschinen-strukturierte Daten, dazu menschenlesbare Tabellen für interaktive Nutzung. **Agenten entdecken Funktionen über das Standard-`--help` und `which`**.++5. **Keine Kompromisse bei Abhängigkeiten** — echte Software ist Pflichtvoraussetzung — keine Fallbacks, keine Graceful Degradation. **Fehlt das Backend, scheitern die Tests statt sie zu überspringen — so bleiben echte Funktionen garantiert.**++---++## 📂 Projektstruktur++```+cli-anything/+├── 📄 README.md # Englisches README+├── 📁 assets/ # Bilder und Medien+│ ├── icon.png # Projekt-Icon+│ └── teaser.png # Teaser-Bild+│+├── 🔌 cli-anything-plugin/ # Claude-Code-Plugin+│ ├── HARNESS.md # Methodik-SOP (Single Source of Truth)+│ ├── README.md # Plugin-Dokumentation+│ ├── QUICKSTART.md # 5-Minuten-Einstieg+│ ├── PUBLISHING.md # Publishing-Guide+│ ├── repl_skin.py # Vereinheitlichte REPL-Oberfläche+│ ├── commands/ # Plugin-Command-Definitionen+│ │ ├── cli-anything.md # Haupt-Build-Befehl+│ │ ├── refine.md # Coverage bestehender Harnesses erweitern+│ │ ├── test.md # Test-Runner+│ │ └── validate.md # Standard-Validierung+│ └── scripts/+│ └── setup-cli-anything.sh # Setup-Skript+│+├── 🤖 codex-skill/ # Codex-Skill-Einstiegspunkt+├── 🎨 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)+├── 📄 libreoffice/agent-harness/ # LibreOffice CLI (158 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)+├── 📐 drawio/agent-harness/ # Draw.io CLI (138 Tests)+├── ✨ anygen/agent-harness/ # AnyGen CLI (50 Tests)+└── 🟩 nsight-graphics/agent-harness/ # Nsight Graphics CLI (40 Tests)+```++Jedes `agent-harness/` enthält ein pip-installierbares Python-Paket unter `cli_anything.<software>/` mit Click-CLI, Core-Modulen, Utilities (inklusive `repl_skin.py` und Backend-Wrappern) und einer umfassenden Test-Suite.++---++## 🎯 Plugin-Befehle++| Befehl | Beschreibung |+|---------|-------------|+| `/cli-anything <Software-Pfad-oder-Repo>` | Komplettes CLI-Harness bauen — alle 7 Phasen |+| `/cli-anything:refine <Software-Pfad> [Fokus]` | Bestehendes Harness verfeinern — Gap-Analyse, mehr Coverage |+| `/cli-anything:test <Software-Pfad-oder-Repo>` | Tests laufen lassen und TEST.md mit Ergebnissen aktualisieren |+| `/cli-anything:validate <Software-Pfad-oder-Repo>` | Gegen den HARNESS.md-Standard validieren |++### Beispiele++```bash+# Komplettes CLI für GIMP aus lokaler Quelle bauen+/cli-anything /home/user/gimp++# Aus einem GitHub-Repo bauen+/cli-anything https://github.com/blender/blender++# Bestehendes Harness verfeinern — breite Gap-Analyse+/cli-anything:refine /home/user/gimp++# Mit einem spezifischen Fokus verfeinern+/cli-anything:refine /home/user/shotcut "Video-in-Video- und Picture-in-Picture-Compositing"++# Tests laufen lassen und TEST.md aktualisieren+/cli-anything:test /home/user/inkscape++# Gegen den HARNESS.md-Standard validieren+/cli-anything:validate /home/user/audacity+```++---++## 🎮 Demo: Generiertes CLI im Einsatz++Beispiel dafür, was ein Agent mit `cli-anything-libreoffice` tun kann:++```bash+# Neues Writer-Dokument anlegen+$ cli-anything-libreoffice document new -o report.json --type writer+✓ Writer-Dokument erstellt: report.json++# Inhalt hinzufügen+$ cli-anything-libreoffice --project report.json writer add-heading -t "Q1-Bericht" --level 1+✓ Überschrift hinzugefügt: "Q1-Bericht"++$ cli-anything-libreoffice --project report.json writer add-table --rows 4 --cols 3+✓ 4×3-Tabelle hinzugefügt++# In echtes PDF exportieren via LibreOffice headless+$ cli-anything-libreoffice --project report.json export render output.pdf -p pdf --overwrite+✓ Export abgeschlossen: output.pdf (42.831 Bytes) via libreoffice-headless++# JSON-Modus für Agenten+$ cli-anything-libreoffice --json document info --project report.json+{+ "name": "Q1 Report",+ "type": "writer",+ "pages": 1,+ "elements": 2,+ "modified": true+}+```++### REPL-Modus++```+$ cli-anything-blender+╔══════════════════════════════════════════╗+║ cli-anything-blender v1.0.0 ║+║ Blender CLI for AI Agents ║+╚══════════════════════════════════════════╝++blender> scene new --name ProductShot+✓ Szene erstellt: ProductShot++blender[ProductShot]> object add-mesh --type cube --location 0 0 1+✓ Mesh hinzugefügt: Cube bei (0, 0, 1)++blender[ProductShot]*> render execute --output render.png --engine CYCLES+✓ Rendering abgeschlossen: render.png (1920×1080, 2,3 MB) via blender --background++blender[ProductShot]> exit+Goodbye! 👋+```++---++## 📖 Das Standard-Playbook: HARNESS.md++`HARNESS.md` ist die definitive SOP, um jede Software über automatische CLI-Generierung agent-zugänglich zu machen.++Sie kodifiziert die bewährten Muster und Methoden, die im Zuge der automatischen Generierung herausgearbeitet wurden.++Das Playbook bündelt die zentralen Erkenntnisse aus dem Bau von 11 unterschiedlichen, produktionsreifen Harnesses.++### Wichtige Lessons-Learned++| Lektion | Beschreibung |+|--------|-------------|+| **Echte Software nutzen** | CLIs müssen die echte Anwendung zum Rendern aufrufen. Nicht Pillow statt GIMP, kein eigener Renderer statt Blender. Gültige Projektdateien generieren → echtes Backend anstoßen. |+| **Render-Lücke** | GUI-Apps wenden Effekte beim Rendern an. Wenn das CLI Projektdateien manipuliert, aber ein naiver Export-Tool verwendet, gehen Effekte stillschweigend verloren. Lösung: nativer Renderer → Filter-Konvertierung → Render-Skript. |+| **Filter-Konvertierung** | Beim Mapping von Effekten zwischen Formaten (MLT → ffmpeg) auf das achten: doppelte Filter zusammenführen, verschachtelte Stream-Reihenfolge, Parameter-Raum-Unterschiede, nicht abbildbare Effekte. |+| **Timecode-Präzision** | Nicht-ganzzahlige Frameraten (29,97 fps) erzeugen kumulative Rundungsfehler. `round()` statt `int()`, Integer-Arithmetik für die Anzeige, ±1-Frame-Toleranz in Tests. |+| **Output-Validierung** | Exit-Code 0 ≠ erfolgreicher Export. Stattdessen prüfen: Magic-Bytes, ZIP-/OOXML-Struktur, Pixel-Analyse, Audio-RMS-Pegel, Längen-Checks. |++> Vollständige Methodik hier: [`cli-anything-plugin/HARNESS.md`](cli-anything-plugin/HARNESS.md)++---++## 📦 Installation & Nutzung++### Für Plugin-Nutzer (Claude Code)++```bash+# Marketplace hinzufügen und installieren (empfohlen)+/plugin marketplace add HKUDS/CLI-Anything+/plugin install cli-anything++# CLI für eine Software mit Codebase bauen+/cli-anything <Software-Name>+```++### Für die generierten CLIs++```bash+# Generiertes CLI installieren+cd <software>/agent-harness+pip install -e .++# Verifizieren+which cli-anything-<software>++# Nutzen+cli-anything-<software> --help+cli-anything-<software> # REPL starten+cli-anything-<software> --json <command> # JSON-Output für Agenten+```++### Tests ausführen++```bash+# Tests für ein bestimmtes CLI laufen lassen+cd <software>/agent-harness+python3 -m pytest cli_anything/<software>/tests/ -v++# Force-Installed-Modus (empfohlen für Verifikation)+CLI_ANYTHING_FORCE_INSTALLED=1 python3 -m pytest cli_anything/<software>/tests/ -v -s+```++---++## 🤝 Mitwirken++Beiträge sind willkommen! CLI-Anything ist auf Erweiterbarkeit ausgelegt:++- **Neue Software-Targets** — generiere mit dem Plugin ein CLI für eine beliebige Codebase und reiche das Harness über [`cli-anything-plugin/PUBLISHING.md`](cli-anything-plugin/PUBLISHING.md) ein.+- **Methodik-Verbesserungen** — PRs gegen `HARNESS.md` mit neuen Lessons-Learned+- **Plugin-Erweiterungen** — neue Befehle, bessere Phasen, robustere Validierung+- **Test-Coverage** — mehr E2E-Szenarien, Edge-Cases, Workflow-Tests++### Einschränkungen++- **Starkes Foundation-Modell nötig** — CLI-Anything braucht ein Modell der Frontier-Klasse (z. B. Claude Opus 4.6, Claude Sonnet 4.6, GPT-5.4), damit die Harness-Generierung zuverlässig ist. Schwächere oder kleinere Modelle erzeugen ggf. unvollständige oder fehlerhafte CLIs, die viel manuelle Nacharbeit erfordern.+- **Abhängig von verfügbarem Quellcode** — die 7-Phasen-Pipeline analysiert und generiert auf Basis des Source-Codes. Liefert die Zielsoftware nur kompilierte Binaries (Decompilation nötig), sinken Qualität und Abdeckung des Harness deutlich.+- **Iterative Verfeinerung kann nötig sein** — ein einzelner `/cli-anything`-Lauf deckt nicht zwangsläufig alle Funktionen vollständig ab. Ein oder mehrere `/refine`-Läufe sind oft erforderlich, um Performance und Coverage des CLIs auf Produktionsniveau zu bringen.++### Roadmap++- [ ] Unterstützung für weitere Anwendungs-Kategorien (CAD, DAW, IDE, EDA, Science-Tools)+- [ ] Benchmark-Suite für Agent-Task-Completion-Rates+- [ ] Community-beigesteuerte CLI-Harnesses für In-House- bzw. Custom-Software+- [ ] Integration mit zusätzlichen Agent-Frameworks neben Claude Code+- [ ] Unterstützung, Closed-Source-Software und Web-Service-APIs in CLIs zu verpacken+- [ ] Zusätzlich zum CLI eine `SKILL.md` für Agent-Skill-Discovery und -Orchestrierung mitgenerieren++---++## 📖 Dokumentation++| Dokument | Beschreibung |+|----------|-------------|+| [`cli-anything-plugin/HARNESS.md`](cli-anything-plugin/HARNESS.md) | Methodik-SOP — Single Source of Truth |+| [`cli-anything-plugin/README.md`](cli-anything-plugin/README.md) | Plugin-Dokumentation — Befehle, Optionen, Phasen |+| [`cli-anything-plugin/QUICKSTART.md`](cli-anything-plugin/QUICKSTART.md) | 5-Minuten-Einstieg |+| [`cli-anything-plugin/PUBLISHING.md`](cli-anything-plugin/PUBLISHING.md) | Distribution- und Publishing-Guide |++Jedes generierte Harness enthält zusätzlich:+- `<SOFTWARE>.md` — die anwendungsspezifische Architektur-SOP+- `tests/TEST.md` — Testplan und Ergebnis-Dokumentation++---++## ⭐ Star-Verlauf++Wenn CLI-Anything dir hilft, deine Software agent-native zu machen, freuen wir uns über einen Stern! ⭐++<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-Diagramm" src="https://api.star-history.com/svg?repos=HKUDS/CLI-Anything&type=Date" />+ </picture>+ </a>+</div>++---++## 📄 Lizenz++Apache License 2.0 — frei nutzbar, modifizierbar und verteilbar.++---++<div align="center">++**CLI-Anything** — *Jede Software mit Codebase agent-native machen.*++<sub>Methodik für das Zeitalter der KI-Agenten | 11 professionelle Software-Demos | 1.508 bestandene Tests</sub>++<br>++<img src="assets/icon.png" alt="CLI-Anything-Icon" width="80">++</div>++<p align="center">+ <em>Danke, dass du dir CLI-Anything ansiehst ✨</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>diff --git a/README_JA.md b/README_JA.mdindex fc42e22fd..54d7915f3 100644--- a/README_JA.md+++ b/README_JA.md@@ -24,7 +24,7 @@ CLI-Anything: AIエージェントと世界のソフトウェアの架け橋</st<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>-**ワンコマンド**: あらゆるソフトウェアをOpenClaw、nanobot、Cursor、Claude Codeなどのエージェント対応に。 [**English**](README.md) | [**中文文档**](README_CN.md)+**ワンコマンド**: あらゆるソフトウェアをOpenClaw、nanobot、Cursor、Claude Codeなどのエージェント対応に。 [**English**](README.md) | [**中文文档**](README_CN.md) | [**Deutsch**](README_DE.md)<p align="center"><img src="assets/cli-typing.gif" alt="CLI-Anything タイピングデモ" width="800">