AI-translated from English; not yet reviewed by a fluent editor.

# Ein Praxisleitfaden zu Rive CLI und Programmieragenten

> Ein Praxisleitfaden dazu, Rive CLI und RML mit einem Programmieragenten zu nutzen, um interaktive Grafiken zu erstellen, zu prüfen und zu testen – einschließlich Konto-, Signatur- und Exportbeschränkungen.

By BIG CHANGE Editorial

Published: 2026-09-27T00:12:27.556Z
Updated: 2026-09-27T00:17:31.324Z
Canonical: https://bigchange.ai/blog/rive-cli-rml-coding-agents-guide

![A designer holds a controller while viewing an orange jointed animation shape on a wall-mounted display, with a smaller screen of indented lines nearby.](https://bigchange.ai/api/media/file/rive-cli-animation-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

Mit der neuen CLI von Rive kann ein Programmieragent interaktive Grafiken als Projektdateien bearbeiten. Der Agent kann Rive Markup Language (RML), Luau-Skripte und Shader schreiben und die CLI anschließend bitten, das Ergebnis zu kompilieren, zu prüfen, zu testen und zu rendern. Ein Mensch kann die lokale Vorschau beobachten und den Entwurf überarbeiten. Mitarbeitende von Rive stellten die CLI als **technische Vorschau am 11. September** vor; auf der [Downloadseite von Rive](https://rive.app/downloads), die am 27. September geprüft wurde, wird sie unter **Early Access** geführt.

Diese Checkliste folgt der [Rive-Dokumentation](https://rive.app/docs/cli/overview). BIG CHANGE hat nur die Dokumentation geprüft. Wir haben die CLI weder installiert noch eine Datei erstellt oder eine von einem Agenten erzeugte Grafik getestet. Rives [Videoanleitung](https://youtu.be/Y3E33otHeLE) zeigt den vorgesehenen Arbeitsablauf zwischen Mensch und Agent.

## Die große Veränderung

- **Was sich geändert hat:** Für Rive-Szenen gibt es jetzt einen textbasierten Arbeitsweg für Programmieragenten. Ein Agent kann RML in einem Projektordner bearbeiten, während die CLI eine `.riv` für Laufzeitumgebungen oder eine `.rev` zur weiteren Bearbeitung im Editor kompiliert.
- **Warum das wichtig ist:** Designer sowie Frontend- und Spieleentwickler können Quelltextänderungen zusammen mit den übrigen Projektdateien prüfen und beim Überarbeiten CLI-Prüfungen nutzen. Bevor sie das Asset in einem Produkt verwenden, müssen sie weiterhin das gerenderte Design und die Interaktionen beurteilen.
- **Worauf es ankommt:** Ein lokaler Prototyp kann nicht automatisch ins Web übernommen werden. Dateien mit Skripten benötigen einen signierten `--publish`; für einen sauberen `.riv` muss das Projekt außerdem an eine Kontodatei gebunden sein und sich in einem Workspace des Tarifs Cadet oder höher befinden. Prüfen Sie diese Bedingungen und die fertige Grafik vor der Bereitstellung.

## Die dokumentierte Aufgabenliste

1. **Zugriff prüfen und installieren.** Rive unterstützt macOS auf Apple Silicon, Linux x86\_64 und Windows. Die [Getting-Started-Anleitung](https://rive.app/docs/cli/getting-started) enthält eigene Installationshinweise für Windows sowie für macOS/Linux; verwenden Sie die aktuellen Windows-Schritte auf dieser Seite. Führen Sie nach der Installation `rive doctor` aus. In der Befehlsreferenz ist außerdem `rive --version` dokumentiert. Notieren Sie die tatsächlich installierte Version, denn die Software ist eine Vorschau. In der Ankündigung vom 11. September hieß es, die CLI sei während *der Vorschau*. Diese datierte Aussage belegt keinen dauerhaft kostenlosen CLI-Preis. Die [aktuelle Tarifübersicht](https://rive.app/pricing) betrifft Rive-Konten und den integrierten Editor-Agenten. Prüfen Sie deshalb vor einer Veröffentlichung die geltenden Bedingungen.
2. **Ein Textprojekt erstellen und die Vorschau öffnen.** `rive create myproject` erstellt `scene.rml`, `rive.yaml`, Agentenanweisungen unter `AGENTS.md` und `CLAUDE.md` sowie eine `.gitignore`. Führen Sie `rive myproject` in einem Terminal aus. Laut Rive überwacht der Befehl den Ordner, baut das Projekt bei jedem Speichern neu auf und schreibt `myproject/build/myproject.riv`. Die Startszene enthält eine Zeichenfläche, eine Zeitleiste und eine Zustandsmaschine, aber noch keine gezeichneten Inhalte. Die erste Vorschau zeigt daher ein dunkles Rechteck.
3. **Geben Sie einem Programmieragenten den Projektordner und eine konkrete Gestaltungsaufgabe.**In Rives [Leitfaden für KI-Agenten](https://rive.app/docs/cli/agents) werden Claude Code, Cursor und andere Agenten genannt, die Dateien lesen und schreiben sowie Shell-Befehle ausführen können. Die erzeugten Anweisungen erklären dem Agenten, wie er `rive docs` und `rive schema` nutzt, um unterstützte Objekte und Eigenschaften zu finden. RML ist XML: Elemente stehen für Rive-Typen, Attribute für deren Eigenschaften und Verschachtelungen verknüpfen Objekte. Der Agent kann außerdem `.luau`-Skripte, `.wgsl`-Shader und Projektressourcen bearbeiten. Lassen Sie ihn schrittweise arbeiten, damit Sie Layout und Verhalten anpassen können, während die Vorschau aktualisiert wird.
4. **Build prüfen und Inhalte kontrollieren.**Bitten Sie den Agenten, `rive myproject --verify` auszuführen. Dieser Befehl kompiliert, ohne eine `.riv` zu schreiben; `rive inspect myproject --summary` meldet Probleme und Objektzahlen. Für eine vollständig aufgelöste Szene ist auch `rive inspect myproject --json` dokumentiert. Wenn Sie ohne Öffnen der Vorschau eine lokal weitergebbare Datei benötigen, schreibt `rive myproject --once` eine unsignierte `.riv`. Diese Prüfungen können Kompilierungsfehler sowie fehlende oder unerwartete Szenenobjekte aufdecken. Der [RML-Leitfaden von Rive](https://rive.app/docs/runtimes/advanced-topic/rml) warnt jedoch, dass ein erfolgreicher Build nicht belegt, dass die Grafik wie beabsichtigt aussieht oder funktioniert.
5. **Wichtige Zustände aufnehmen.** `rive myproject --screenshot=out.png` rendert ohne geöffnetes Fenster eine PNG-Datei. Rives [Beispiele](https://rive.app/docs/cli/examples) verwenden `--advance=1s` für ein Bild nach dem Start der Animation, `--viewport=390x844` für eine bestimmte Fenstergröße, `--data=battery/level=100` für gebundene Daten und `--pointer=click@120,60 --advance=20` für einen simulierten Klick. Wählen Sie Werte und Koordinaten passend zu Ihrer eigenen Szene. Vergleichen Sie Aufnahmen verschiedener Zustände und Ansichtsgrößen und prüfen Sie sie anschließend selbst. Eine Aufnahme ohne `--advance` zeigt die gestaltete Ruhepose und nicht unbedingt das erste Bild der Animation.
6. **Skripttests ausführen, wenn das Projekt welche enthält.** `rive myproject --test` führt die Luau-`Tests`-Skripte des Projekts aus. Rive dokumentiert `--verify --format=json` und `--test --format=json` für automatisierte Prüfungen; fehlgeschlagene Builds und Tests enden mit einem von null verschiedenen Statuscode. Ein Agent kann die Berichte zur Überarbeitung des Quelltexts verwenden. Tests decken nur die tatsächlich formulierten Prüfungen ab; kontrollieren Sie daher auch die Interaktionen, die sie auslassen.
7. **Kontopfad wählen, sobald der lokale Prototyp bereit ist.**Eine `.riv` ist das Laufzeit-Asset; eine `.rev` lässt sich zur Bearbeitung im Rive-Editor öffnen. Laut Rive funktionieren lokale Erstellung, Vorschau, Prüfung, Tests und Screenshots auch ohne Anmeldung und offline. `rive login` ist eine Anmeldung erforderlich für `--publish`, `--rev`, `rive push`, `rive pull` und den Import einer Datei aus einem Online-Konto. Um mit einem aus dem Editor exportierten Backup zu beginnen, ist `rive create myproject --from-rev=myfile.rev` ohne Anmeldung verfügbar. Wenn Sie mit einer Kontodatei beginnen möchten, verwenden Sie nach der Anmeldung `rive create myproject --from-remote-file`. Damit wird das Projekt mit dieser Datei verknüpft: `rive push myproject` lädt eine neue Version hoch; `rive pull myproject` übernimmt Änderungen aus dem Editor;  **überschreibt nach Bestätigung lokale Szenen, Skripte und Assets** . Prüfen Sie lokale Änderungen, bevor Sie Änderungen herunterladen.
8. **Vor dem Veröffentlichen Signatur- und Exportbeschränkungen prüfen.** `rive myproject --publish` erstellt eine signierte `.riv` und erfordert eine Anmeldung. Rive zufolge lehnen Web-Laufzeitumgebungen und das CDN unsignierte Skripte ab; eine Datei mit Skripten für das Web muss daher auf diesem Weg erstellt werden. `--publish` kann ein Wasserzeichen hinzufügen. Laut [Befehlsreferenz](https://rive.app/docs/cli/reference/commands) von Rive muss das Projekt für einen erfolgreichen `.riv` über `rive push` an eine Kontodatei gebunden sein. Diese Datei muss sich in einem Workspace des Tarifs Cadet oder höher befinden. Die Wasserzeichenbedingung gilt auch, wenn die Szene keine Skripte enthält. `--rev=<path>` erfordert ebenfalls eine Anmeldung und kann zusammen mit `--once` oder `--publish` verwendet werden; der Befehl schreibt eine Editor-Datei und ist kein Ersatz für ein Laufzeit-Asset. Prüfen Sie vor der Bereitstellung den aktuellen Kontotarif und das tatsächlich exportierte Ergebnis.

Rive bietet außerdem einen [integrierten KI-Agenten im Editor](https://rive.app/docs/editor/ai-agent). Er wird über die Seitenleiste des Editors geöffnet und unterliegt den Tarif- und KI-Guthabenbedingungen des Editors. Dieser Leitfaden behandelt den Arbeitsablauf über Ordner und Terminal mit einem Programmieragenten und der CLI; die beiden Agentenwege haben unterschiedliche Oberflächen und Abrechnungsmodelle.

## Quellen und weiterführende Informationen

- [Rive-CLI-Übersicht](https://rive.app/docs/cli/overview) erläutert den Arbeitsablauf im Terminal, die Ausgabeformate, die Vorschau und den Austausch mit Kontodateien.
- [Getting Started](https://rive.app/docs/cli/getting-started) beschreibt unterstützte Systeme, Installation, Projektgerüst, lokalen Build und Anmeldebedingungen.
- [Arbeiten mit KI-Agenten](https://rive.app/docs/cli/agents) zeigt, wie ein Programmieragent die erzeugten Projektanweisungen und Rückmeldungen der CLI nutzt. Der [Leitfaden für den integrierten Editor-Agenten](https://rive.app/docs/editor/ai-agent) beschreibt die separate Editor-Oberfläche.
- [RML-Leitfaden](https://rive.app/docs/runtimes/advanced-topic/rml), [Befehlsreferenz](https://rive.app/docs/cli/reference/commands) und [Beispiele](https://rive.app/docs/cli/examples) belegen das Dateimodell, die genauen Befehle, Tests, Aufnahmeverhalten und Veröffentlichungsbeschränkungen.
- [Ankündigung der Mitarbeitenden vom 11. September](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) datiert die technische Vorschau und ihre vorübergehende kostenlose Nutzung der CLI. [Downloads](https://rive.app/downloads) führt die CLI aktuell unter „Early Access“; die [Preisseite](https://rive.app/pricing) listet die Kontotarife. Sehen Sie sich Rives [Videoanleitung](https://youtu.be/Y3E33otHeLE) zum Arbeitsablauf zwischen Mensch und Agent an.

## Sources

- [Übersicht zu Rive CLI](https://rive.app/docs/cli/overview) — Definiert den Zweck der CLI, lokale .riv- und Editor-.rev-Ausgaben, Live-Vorschau, Prüf- und Testfunktionen, Aufnahmen sowie den Austausch mit Online-Dateien.
- [Rive CLI: Getting Started](https://rive.app/docs/cli/getting-started) — Dokumentiert unterstützte Plattformen, Installation, Projektgerüst, Vorschauausgabe, .rev und Remote-Import, Anmeldeanforderungen, Skriptsignierung und Wasserzeichenbedingungen.
- [Arbeiten mit KI-Agenten](https://rive.app/docs/cli/agents) — Dokumentiert den Einsatz mit externen Programmieragenten, erzeugte Agentenanweisungen, Referenzsuche, Verifizierung, Inspektion und schrittweise menschliche Steuerung.
- [Rive Markup Language](https://rive.app/docs/runtimes/advanced-topic/rml) — Definiert den Aufbau von RML, die Kompilierung textbasierter Projekte und die getrennten visuellen Prüfungen; hält ausdrücklich fest, dass ein erfolgreicher Build weder das beabsichtigte Verhalten noch die gewünschte Darstellung belegt.
- [Rive CLI: Befehlsreferenz](https://rive.app/docs/cli/reference/commands) — Primärquelle für genaue Befehle, Optionen, Rückgabestatus, Remote-Push und -Pull, Kontoanmeldung, Signierung, .rev-Export und Anforderungen für einen sauberen .riv-Export.
- [Rive CLI: Beispiele](https://rive.app/docs/cli/examples) — Zeigt Screenshots ohne geöffnetes Fenster, Zeitschritte, Ansichtsgrößen, Daten- und Zeigereingaben, Luau-Tests und JSON-Berichte. BIG CHANGE hat die Beispiele dokumentiert, aber nicht selbst ausgeführt.
- [Rive KI-Agent](https://rive.app/docs/editor/ai-agent) — Beschreibt Rives separaten, integrierten Editor-Agenten und dessen Tarif- und KI-Guthabenbedingungen.
- [Rive-Downloads](https://rive.app/downloads) — Die aktuelle Seite führt Rive CLI unter „Early Access“.
- [Rive-Preise](https://rive.app/pricing) — Listet aktuelle Bedingungen für Konten und den Editor-Agenten, getrennt von der datierten Preisangabe zur Vorschau der CLI.
- [Einführung der Rive CLI und RML](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) — Die Mitarbeitenden von Rive bezeichnen die Veröffentlichung als technische Vorschau und geben an, dass die CLI während dieser Vorschau unbegrenzt kostenlos ist. Die Ankündigung erläutert auch die Rollen von .riv, .rev und RML und verlinkt eine Videoanleitung.
- [Videoanleitung zu Rive CLI](https://youtu.be/Y3E33otHeLE) — Vom Eigentümer bereitgestellter Videolink, der im Artikeltext und in den Quellen enthalten ist; es werden keine Aussagen zu konkreten Szenen oder Ergebnissen des Videos gemacht.