Édition Markdown

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

# Guide pratique de Rive CLI et des agents de programmation

> Guide pratique pour utiliser Rive CLI et RML avec un agent de programmation afin de créer, examiner et tester des graphiques interactifs, avec les limites liées aux comptes, à la signature et à l’exportation.

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.

Le nouveau CLI de Rive permet à un agent de programmation de travailler sur des graphiques interactifs sous forme de fichiers de projet. L’agent peut écrire du Rive Markup Language (RML), des scripts Luau et des shaders, puis demander au CLI de compiler, d’examiner, de tester et de rendre le résultat. Une personne peut suivre l’aperçu local et revoir le design. L’équipe de Rive a présenté le CLI comme un **aperçu technique le 11 septembre**. La page [Téléchargements de Rive](https://rive.app/downloads), consultée le 27 septembre, le classe dans la section **Early Access**.

Ce guide pratique suit la [documentation de Rive](https://rive.app/docs/cli/overview). BIG CHANGE a uniquement examiné la documentation. Nous n’avons pas installé le CLI, créé de fichier ni testé de graphique produit par un agent. La [vidéo explicative](https://youtu.be/Y3E33otHeLE) de Rive montre le processus prévu, avec collaboration entre une personne et un agent.

## Le grand changement

- **Ce qui a changé :** Les scènes Rive peuvent désormais être modifiées par des agents de programmation à l’aide de texte. Un agent peut modifier RML dans un dossier de projet, tandis que le CLI compile un `.riv` destiné aux environnements d’exécution ou un `.rev` pour poursuivre le travail dans l’éditeur.
- **Pourquoi c’est important :** Les designers et les développeurs front-end ou de jeux vidéo peuvent examiner les modifications du code source avec leurs autres fichiers de projet et utiliser les vérifications du CLI pendant les itérations. Ils doivent toujours juger le rendu graphique et les interactions avant d’intégrer le visuel à un produit.
- **À suivre :** Passer d’un prototype local au Web est une décision distincte. Les fichiers contenant des scripts doivent être compilés avec l’option `--publish` pour produire un fichier signé ; un fichier `.riv` sans filigrane nécessite également que le projet soit associé à un fichier de compte et que celui-ci se trouve dans un espace de travail de niveau Cadet ou supérieur. Vérifiez ces conditions et le rendu final avant le déploiement.

## La liste des étapes documentées

1. **Vérifiez l’accès et installez le CLI.** Rive indique que macOS sur Apple Silicon, Linux x86\_64 et Windows sont pris en charge. Son guide [Premiers pas](https://rive.app/docs/cli/getting-started) fournit des instructions d’installation distinctes pour Windows et macOS/Linux ; suivez les instructions Windows à jour sur cette page. Après l’installation, exécutez `rive doctor`. Le guide de référence documente également `rive --version` ; notez la version effectivement installée, car le logiciel est encore en aperçu. Dans son annonce du 11 septembre, Rive indiquait que le CLI était gratuit et sans limite *pendant la période d’aperçu*. Cette déclaration datée ne garantit pas que le CLI restera gratuit. Le [tableau des formules actuel](https://rive.app/pricing) concerne les comptes Rive et l’agent intégré à l’éditeur ; vérifiez donc les conditions en vigueur avant toute publication.
2. **Créez un projet textuel et ouvrez l’aperçu.** `rive create myproject` crée `scene.rml`, `rive.yaml`, des instructions pour les agents dans `AGENTS.md` et `CLAUDE.md`, ainsi qu’un `.gitignore`. Exécutez `rive myproject` dans un terminal. Selon Rive, le CLI surveille le dossier, recompile à chaque enregistrement et écrit `myproject/build/myproject.riv`. La scène de départ contient un plan de travail, une chronologie et une machine à états, mais aucun dessin. L’aperçu initial est un rectangle sombre.
3. **Donnez à un agent de programmation le dossier du projet et une tâche de design précise.** Le guide de Rive sur les [agents d’IA](https://rive.app/docs/cli/agents) cite Claude Code, Cursor ou tout autre agent capable de lire et d’écrire des fichiers et d’exécuter des commandes shell. Les instructions générées indiquent à l’agent comment utiliser `rive docs` et `rive schema` pour trouver les objets et propriétés pris en charge. RML est un langage XML : les éléments représentent des types Rive, les attributs représentent leurs propriétés et l’imbrication relie les objets. L’agent peut également modifier les scripts `.luau`, les shaders `.wgsl` et les ressources du projet. Demandez-lui de procéder par étapes afin de pouvoir réorienter la mise en page et le comportement pendant que l’aperçu s’actualise.
4. **Vérifiez la compilation et son contenu.** Demandez à l’agent d’exécuter `rive myproject --verify`, qui compile sans écrire de fichier `.riv`, puis `rive inspect myproject --summary`, qui signale les problèmes et le nombre d’objets. Pour afficher la scène entièrement résolue, la documentation prévoit `rive inspect myproject --json`. Si le projet nécessite un fichier local distribuable sans ouvrir l’aperçu, `rive myproject --once` produit un fichier `.riv` non signé. Ces vérifications peuvent détecter les erreurs de compilation et les objets absents ou inattendus dans la scène. Le [guide RML de Rive](https://rive.app/docs/runtimes/advanced-topic/rml) précise qu’une compilation réussie ne prouve pas qu’un graphique a l’apparence ou le comportement souhaités.
5. **Capturez les états importants.** `rive myproject --screenshot=out.png` produit un PNG sans ouvrir de fenêtre. Les [exemples](https://rive.app/docs/cli/examples) de Rive utilisent `--advance=1s` pour capturer une image après le début de l’animation, `--viewport=390x844` pour définir la taille de mise en page, `--data=battery/level=100` pour les données associées et `--pointer=click@120,60 --advance=20` pour simuler un clic. Choisissez les valeurs et les coordonnées d’après votre propre scène. Comparez les captures entre différents états et formats d’affichage, puis examinez-les vous-même. Une capture sans `--advance` correspond à la pose de repos créée par l’auteur ; ce n’est pas nécessairement l’image d’ouverture de l’animation.
6. **Lancez les tests de scripts lorsqu’ils sont présents dans le projet.** `rive myproject --test` exécute les scripts Luau du dossier `Tests` du projet. Rive documente `--verify --format=json` et `--test --format=json` pour les vérifications automatisées ; les échecs de compilation et de test renvoient un code de sortie non nul. Un agent peut s’appuyer sur ces rapports pour modifier le code source. Les tests ne couvrent que les assertions qui y sont rédigées ; examinez donc aussi les interactions que les tests ne vérifient pas.
7. **Choisissez la voie avec compte lorsque le prototype local est prêt.** Un `.riv` est la ressource d’exécution ; un `.rev` s’ouvre pour être modifié dans l’éditeur Rive. Selon Rive, la création locale, l’aperçu, la vérification, les tests et les captures d’écran fonctionnent sans connexion et hors ligne. La commande `rive login` est nécessaire pour `--publish`, `--rev`, `rive push`, `rive pull` et l’importation d’un fichier de compte distant. Pour partir d’une sauvegarde exportée depuis l’éditeur, `rive create myproject --from-rev=myfile.rev` fonctionne sans connexion. Pour partir d’un fichier de compte, utilisez `rive create myproject --from-remote-file` après vous être connecté. Cette dernière commande associe le projet à ce fichier : `rive push myproject` téléverse une révision ; `rive pull myproject` récupère les modifications faites dans l’éditeur et **remplace les scènes, scripts et ressources locaux** après confirmation. Examinez les modifications locales avant de récupérer ces changements.
8. **Vérifiez les limites de signature et d’exportation avant la livraison.** `rive myproject --publish` crée un `.riv` signé et nécessite une connexion. Rive indique que les environnements d’exécution Web et son CDN rejettent les scripts non signés ; un fichier contenant des scripts destinés au Web doit donc suivre cette procédure. `--publish` peut ajouter un filigrane. Le [guide de référence des commandes](https://rive.app/docs/cli/reference/commands) indique qu’un fichier `.riv` sans filigrane nécessite que le projet soit associé à un fichier de compte par l’intermédiaire de `rive push` et que ce fichier se trouve dans un espace de travail de niveau Cadet ou supérieur. Cette condition de filigrane s’applique même si la scène ne contient pas de scripts. `--rev=<path>` nécessite également une connexion et peut accompagner `--once` ou `--publish` ; cette commande écrit un fichier d’éditeur et ne remplace pas une ressource d’exécution. Vérifiez la formule actuelle du compte et le fichier effectivement exporté avant le déploiement.

Rive propose également un [agent d’IA intégré à l’éditeur](https://rive.app/docs/editor/ai-agent). Il s’ouvre depuis le panneau latéral de l’éditeur et dépend de la formule de l’éditeur et des conditions relatives aux crédits d’IA. Dans ce guide, le processus utilisant dossier et terminal fait appel à un agent de programmation associé au CLI ; ces deux modes d’utilisation de l’agent ont des interfaces et des modalités de facturation différentes.

## Sources et lectures complémentaires

- [Présentation de Rive CLI](https://rive.app/docs/cli/overview) décrit le processus en terminal, les formats de sortie, l’aperçu et l’échange de fichiers de compte.
- [Premiers pas](https://rive.app/docs/cli/getting-started) précise les systèmes pris en charge, l’installation, le contenu du modèle de projet, la compilation locale et les conditions de connexion.
- [Travailler avec des agents d’IA](https://rive.app/docs/cli/agents) montre comment un agent de programmation utilise les instructions générées pour le projet et les retours du CLI. Le [guide de l’agent intégré à l’éditeur](https://rive.app/docs/editor/ai-agent) décrit l’interface distincte de l’éditeur.
- [Guide RML](https://rive.app/docs/runtimes/advanced-topic/rml), [guide de référence des commandes](https://rive.app/docs/cli/reference/commands) et [exemples](https://rive.app/docs/cli/examples) étayent le modèle de fichiers, les commandes précises, les tests, les modalités de capture et les limites de publication.
- [Annonce du personnel du 11 septembre](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) date l’aperçu technique et la déclaration temporaire selon laquelle le CLI était gratuit. La page [Téléchargements](https://rive.app/downloads) classe actuellement le CLI en accès anticipé ; la page [Tarifs](https://rive.app/pricing) présente les formules des comptes. Regardez la [vidéo explicative de Rive](https://youtu.be/Y3E33otHeLE) pour voir le processus entre la personne et l’agent.

## Sources

- [Présentation de Rive CLI](https://rive.app/docs/cli/overview) — Définit l’objectif du CLI, les sorties locales .riv et éditeur .rev, l’aperçu en direct, les fonctions d’examen, de test et de capture, ainsi que l’échange de fichiers distants.
- [Premiers pas avec Rive CLI](https://rive.app/docs/cli/getting-started) — Documente les plateformes prises en charge, l’installation, le modèle de projet, la sortie de l’aperçu, .rev et l’importation à distance, les besoins de connexion, la signature des scripts et les conditions de filigrane.
- [Travailler avec des agents d’IA](https://rive.app/docs/cli/agents) — Documente l’utilisation avec des agents de programmation externes, les instructions générées, la recherche de références, la vérification, l’examen et l’orientation humaine par étapes.
- [Rive Markup Language](https://rive.app/docs/runtimes/advanced-topic/rml) — Définit la structure RML, la compilation de projets textuels et distingue les vérifications de compilation, d’inspection et d’aspect visuel ; précise explicitement qu’une compilation réussie ne garantit ni le comportement ni l’apparence souhaités.
- [Référence des commandes Rive CLI](https://rive.app/docs/cli/reference/commands) — Source principale pour les commandes et options précises, les codes de sortie, le transfert distant, l’authentification du compte, la signature, l’export .rev et les conditions pour obtenir un .riv sans filigrane.
- [Exemples Rive CLI](https://rive.app/docs/cli/examples) — Montre les captures d’écran sans interface, l’avance de l’animation, la taille d’affichage, les données et les interactions du pointeur, les tests Luau et les rapports JSON ; BIG CHANGE n’a pas exécuté ces exemples documentés.
- [Agent d’IA de Rive](https://rive.app/docs/editor/ai-agent) — Décrit l’agent d’IA distinct intégré à l’éditeur Rive, ainsi que les conditions associées à la formule et aux crédits d’IA.
- [Téléchargements Rive](https://rive.app/downloads) — La page actuelle classe Rive CLI dans la section Early Access.
- [Tarifs Rive](https://rive.app/pricing) — Présente les conditions actuelles des formules de compte et de l’agent de l’éditeur ; elles sont distinguées de la déclaration datée sur le prix temporaire du CLI pendant l’aperçu.
- [Présentation du CLI et du RML de Rive](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) — L’annonce de l’équipe de Rive présente la sortie comme un aperçu technique et indique que le CLI est gratuit sans limites pendant cette période. Elle explique également les rôles de .riv, .rev et RML et renvoie à une vidéo explicative.
- [Vidéo explicative de Rive CLI](https://youtu.be/Y3E33otHeLE) — Vidéo fournie par le propriétaire et citée dans le corps de l’article et les sources ; aucune affirmation particulière sur une scène ou un résultat de la vidéo n’est avancée.