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, consultée le 27 septembre, le classe dans la section Early Access.

Ce guide pratique suit la documentation de Rive. 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 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 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 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 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 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 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 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. 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