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

# Guía práctica de Rive CLI y los agentes de programación

> Guía práctica para usar Rive CLI y RML con un agente de programación para crear, inspeccionar y probar gráficos interactivos, incluidos los límites de cuenta, firma y exportación.

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.

La nueva CLI de Rive permite que un agente de programación trabaje con gráficos interactivos como archivos de proyecto. El agente puede escribir Rive Markup Language (RML), scripts de Luau y sombreadores; después, puede pedir a la CLI que compile, inspeccione, pruebe y renderice el resultado. Una persona puede ver la vista previa local y revisar el diseño. El equipo de Rive presentó la CLI como una **vista previa técnica el 11 de septiembre**; [la página de descargas de Rive](https://rive.app/downloads), consultada el 27 de septiembre, la incluye en **Early Access**.

Esta lista de comprobación sigue [la documentación de Rive](https://rive.app/docs/cli/overview). BIG CHANGE solo revisó la documentación. No instalamos la CLI, no creamos un archivo ni probamos gráficos generados por un agente. El [vídeo explicativo](https://youtu.be/Y3E33otHeLE) de Rive muestra el flujo de trabajo previsto entre la persona y el agente.

## El gran cambio

- **Qué ha cambiado:** Las escenas de Rive ahora tienen una vía basada en texto para los agentes de programación. Un agente puede editar RML en una carpeta de proyecto, mientras la CLI compila un `.riv` para los entornos de ejecución o un `.rev` para seguir trabajando en el Editor. 
- **Por qué importa:** Diseñadores y desarrolladores de interfaces o videojuegos pueden revisar los cambios en el código fuente junto con los demás archivos del proyecto y usar comprobaciones de CLI durante la iteración. Aun así, antes de utilizar el recurso en un producto deben evaluar el diseño renderizado y las interacciones. 
- **Qué conviene observar:** Llevar un prototipo local a la web es una decisión aparte. Los archivos con scripts requieren compilar con la opción `--publish` para publicar en la web; una compilación limpia de `.riv` también requiere vincular el proyecto a un archivo de cuenta y disponer de un espacio de trabajo Cadet o superior. Antes del despliegue, compruebe esas condiciones y el gráfico exportado.

## La lista de tareas documentada

1. **Compruebe el acceso e instale la CLI.** Rive indica que son compatibles macOS en Apple Silicon, Linux x86\_64 y Windows. Su [guía de inicio](https://rive.app/docs/cli/getting-started) ofrece instrucciones de instalación distintas para Windows y macOS/Linux; siga las instrucciones vigentes para Windows que aparecen en esa página. Después de instalarla, ejecute `rive doctor`. La referencia de comandos también documenta `rive --version`; anote la versión que instale, porque se trata de software en versión preliminar. En su anuncio del 11 de septiembre, Rive dijo que la CLI sería gratuita y sin límites *durante la vista previa*. Esa declaración fechada no establece un precio permanente para la CLI. La [tabla actual de planes ](https://rive.app/pricing) se refiere a las cuentas de Rive y al agente integrado en el Editor, así que consulte las condiciones vigentes antes de publicar.
2. **Cree un proyecto de texto y abra la vista previa.** `rive create myproject` genera `scene.rml`, `rive.yaml`, instrucciones para agentes en `AGENTS.md` y `CLAUDE.md`, y un `.gitignore`. Ejecute `rive myproject` en una terminal. Según Rive, vigila la carpeta, vuelve a compilar cuando se guardan cambios y escribe `myproject/build/myproject.riv`. La escena inicial contiene una mesa de trabajo, una línea de tiempo y una máquina de estados, pero aún no incluye elementos gráficos. La vista previa inicial es un rectángulo oscuro. 
3. **Proporcione al agente de programación la carpeta del proyecto y una tarea de diseño concreta.** La [guía de agentes de IA de Rive ](https://rive.app/docs/cli/agents) menciona Claude Code, Cursor u otro agente que pueda leer y escribir archivos y ejecutar comandos de shell. Las instrucciones generadas explican al agente cómo usar `rive docs` y `rive schema` para encontrar objetos y propiedades compatibles. RML es XML: los elementos representan tipos de Rive, los atributos representan sus propiedades y la jerarquía conecta los objetos. El agente también puede editar `.luau` scripts, `.wgsl` sombreadores y recursos del proyecto. Pídale que trabaje por etapas para poder orientar el diseño y el comportamiento mientras se actualiza la vista previa.
4. **Compruebe la compilación y su contenido.**  Pida al agente que ejecute `rive myproject --verify`, que compila sin escribir un archivo `.riv`, y `rive inspect myproject --summary`, que informa de los problemas y del número de objetos. La documentación indica que para ver la escena completa resuelta se puede usar `rive inspect myproject --json`. Si el proyecto necesita un archivo local distribuible sin abrir la vista previa, `rive myproject --once` escribe un archivo `.riv` sin firmar. Estas comprobaciones pueden detectar errores de compilación y objetos de escena ausentes o inesperados. La [guía de RML de Rive ](https://rive.app/docs/runtimes/advanced-topic/rml) advierte que una compilación limpia no demuestra que el gráfico tenga el aspecto o el comportamiento previstos. 
5. **Capture los estados relevantes.**  `rive myproject --screenshot=out.png` renderiza un PNG sin abrir una ventana. Los [ejemplos de Rive ](https://rive.app/docs/cli/examples) usan `--advance=1s` para capturar un fotograma después de que empiece la animación, `--viewport=390x844` para elegir el tamaño de disposición, `--data=battery/level=100` para los datos vinculados y `--pointer=click@120,60 --advance=20` para simular un clic. Elija valores y coordenadas que correspondan a su propia escena. Compare capturas de distintos estados y tamaños de ventana y luego revíselas personalmente. Una captura sin `--advance` muestra la pose de reposo creada por el autor; no necesariamente el primer fotograma de la animación. 
6. **Ejecute pruebas de scripts cuando el proyecto las incluya.**  `rive myproject --test` ejecuta los scripts Luau del proyecto `Tests`. Rive documenta `--verify --format=json` y `--test --format=json` para las comprobaciones automatizadas; las compilaciones y pruebas fallidas devuelven un código de salida distinto de cero. Un agente puede usar esos informes para revisar el código fuente. Las pruebas solo cubren las condiciones que se hayan definido; compruebe también las interacciones que no incluyan. 
7. **Elija la opción de cuenta cuando el prototipo local esté listo.**  Un archivo `.riv` es el recurso para el entorno de ejecución; un archivo `.rev` se abre para editarse en Rive Editor. Rive dice que se pueden crear, previsualizar y verificar archivos localmente, ejecutar pruebas y tomar capturas sin iniciar sesión y sin conexión. Hace falta `rive login` para `--publish`, `--rev`, `rive push`, `rive pull` e importar un archivo remoto de la cuenta. Para empezar a partir de una copia de seguridad exportada del Editor, `rive create myproject --from-rev=myfile.rev` funciona sin iniciar sesión. Para empezar desde un archivo de la cuenta, use `rive create myproject --from-remote-file` después de iniciar sesión. Esta última opción vincula el proyecto a ese archivo: `rive push myproject` sube una revisión; `rive pull myproject` descarga los cambios del Editor y  **sobrescribe la escena, los scripts y los recursos locales**  tras la confirmación. Revise los cambios locales antes de descargarlos. 
8. **Compruebe los requisitos de firma y exportación antes del lanzamiento.**  `rive myproject --publish` escribe un archivo firmado `.riv` y requiere iniciar sesión. Rive dice que los entornos web y su CDN rechazan scripts sin firmar, así que los archivos con scripts para la web deben exportarse por esta vía. `--publish` puede añadir una marca de agua. La [referencia de comandos de Rive ](https://rive.app/docs/cli/reference/commands) indica que una compilación limpia de `.riv` requiere que el proyecto esté vinculado a un archivo de cuenta mediante `rive push` y que ese archivo esté en un espacio de trabajo Cadet o superior. La condición de la marca de agua también se aplica si la escena no tiene scripts. `--rev=<path>` también requiere iniciar sesión y puede acompañar a `--once` o `--publish`; genera un archivo de Editor, no un sustituto del recurso para el entorno de ejecución. Antes del despliegue, compruebe el plan actual de la cuenta y el resultado exportado. 

Rive también ofrece un [agente de IA integrado en el Editor ](https://rive.app/docs/editor/ai-agent). Se abre desde la barra lateral del Editor y está sujeto al plan y a las condiciones de créditos de IA del Editor. El flujo de trabajo de esta guía, basado en carpetas y terminal, utiliza un agente de programación junto con la CLI; las dos opciones tienen interfaces y condiciones de facturación distintas. 

## Fuentes y lecturas adicionales 

- [Descripción general de Rive CLI ](https://rive.app/docs/cli/overview) explica el flujo de trabajo en terminal, los formatos de salida, la vista previa y el intercambio de archivos de cuenta. 
- [Introducción ](https://rive.app/docs/cli/getting-started) describe los sistemas compatibles, la instalación, el contenido del proyecto inicial y las condiciones para compilar e iniciar sesión localmente. 
- [Trabajar con agentes de IA ](https://rive.app/docs/cli/agents) muestra cómo un agente de programación utiliza las instrucciones generadas para el proyecto y los resultados de la CLI. La [guía del agente integrado en el Editor ](https://rive.app/docs/editor/ai-agent) describe la interfaz independiente del Editor. 
- [Guía de RML ](https://rive.app/docs/runtimes/advanced-topic/rml), [referencia de comandos ](https://rive.app/docs/cli/reference/commands) y [ejemplos ](https://rive.app/docs/cli/examples) respaldan la estructura de archivos, los comandos exactos, las pruebas, la captura y los límites de publicación. 
- [Anuncio del equipo de Rive del 11 de septiembre ](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) fecha la vista previa técnica y la declaración temporal de que la CLI sería gratuita. [Descargas ](https://rive.app/downloads) actualmente clasifica la CLI como Early Access; la página de [precios ](https://rive.app/pricing) enumera los planes de cuenta. Consulte también el [vídeo explicativo de Rive ](https://youtu.be/Y3E33otHeLE) sobre el flujo de trabajo entre personas y agentes. 

## Sources

- [Descripción general de Rive CLI ](https://rive.app/docs/cli/overview) — Define el propósito de la CLI, los formatos locales .riv y del Editor .rev, la vista previa activa, las capacidades de inspección, prueba y captura, y el intercambio de archivos remotos. 
- [Introducción a Rive CLI ](https://rive.app/docs/cli/getting-started) — Documenta las plataformas compatibles, la instalación, la estructura inicial del proyecto, el resultado de la vista previa, .rev y la importación remota, así como los requisitos de inicio de sesión, firma de scripts y marcas de agua. 
- [Trabajar con agentes de IA ](https://rive.app/docs/cli/agents) — Documenta el uso con agentes de programación externos, las instrucciones generadas, la búsqueda de referencias, la verificación, la inspección y la orientación humana por etapas. 
- [Rive Markup Language ](https://rive.app/docs/runtimes/advanced-topic/rml) — Define la estructura de RML, la compilación de proyectos de texto y las comprobaciones independientes de compilación, inspección y aspecto visual; advierte explícitamente que una compilación limpia no demuestra que el comportamiento o el aspecto sean los previstos. 
- [Referencia de comandos de Rive CLI ](https://rive.app/docs/cli/reference/commands) — Referencia primaria para los comandos y argumentos exactos, el comportamiento de salida, sincronización remota, autenticación de cuenta, firma, exportación .rev y requisitos para generar un .riv limpio. 
- [Ejemplos de Rive CLI ](https://rive.app/docs/cli/examples) — Muestra capturas de pantalla sin interfaz, avance de animación, tamaño de ventana, entrada de datos y puntero, pruebas de Luau e informes JSON; son ejemplos documentados, no ejecutados por BIG CHANGE. 
- [Agente de IA de Rive ](https://rive.app/docs/editor/ai-agent) — Describe por separado el agente integrado en el Editor de Rive y las condiciones de su plan y créditos de IA. 
- [Descargas de Rive ](https://rive.app/downloads) — La página actual incluye Rive CLI en Early Access. 
- [Precios de Rive ](https://rive.app/pricing) — Enumera las condiciones actuales de los planes de cuenta y del agente del Editor; se tratan por separado de la declaración de precios de la CLI durante la vista previa. 
- [Presentamos Rive CLI y RML ](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) — El anuncio del equipo de Rive presenta el lanzamiento como una vista previa técnica y afirma que la CLI será gratuita y sin límites durante ese periodo. También explica las funciones de .riv, .rev y RML, y enlaza a una demostración en vídeo. 
- [Recorrido en vídeo de Rive CLI ](https://youtu.be/Y3E33otHeLE) — Enlace al vídeo proporcionado por el propietario, incluido en el cuerpo y las fuentes; no se hacen afirmaciones específicas sobre escenas o resultados del vídeo.