mirror of
https://github.com/HKUDS/CLI-Anything.git
synced 2026-09-01 15:36:07 +08:00
docs: add German translation (README_DE.md) and update language switchers
- Adds README_DE.md, a full German translation modeled on README_JA.md. - Extends the inline language switcher in README.md and README_JA.md with a Deutsch link. - Adds README_DE.md to the .gitignore allow-list (root README_* files are gated).
This commit is contained in:
@@ -272,6 +272,7 @@
|
||||
|
||||
assets/gen_typing_gif.py
|
||||
!README_CN.md
|
||||
!README_DE.md
|
||||
!opencode-commands/
|
||||
!/qoder-plugin/
|
||||
|
||||
|
||||
@@ -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">
|
||||
|
||||
+892
@@ -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>
|
||||
+1
-1
@@ -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">
|
||||
|
||||
Reference in New Issue
Block a user