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

# Guia prático do Rive CLI para agentes de programação

> Guia prático para usar Rive CLI e RML com um agente de programação na criação, inspeção e teste de gráficos interativos, incluindo limites de conta, assinatura e exportação.

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.

O novo CLI do Rive permite que um agente de programação trabalhe com gráficos interativos em arquivos de projeto. O agente pode escrever Rive Markup Language (RML), scripts Luau e shaders e, em seguida, pedir ao CLI que compile, inspecione, teste e renderize o resultado. Uma pessoa pode acompanhar a pré-visualização local e revisar o design. A equipe do Rive apresentou o CLI como uma **prévia técnica em 11 de setembro**; a [página de Downloads do Rive](https://rive.app/downloads), consultada em 27 de setembro, o lista como **Acesso Antecipado**.

Esta lista segue a [documentação do Rive](https://rive.app/docs/cli/overview). A BIG CHANGE revisou apenas a documentação. Não instalamos o CLI, criamos um arquivo nem testamos um gráfico produzido por agente. O [vídeo demonstrativo](https://youtu.be/Y3E33otHeLE) do Rive mostra o fluxo de trabalho previsto entre a pessoa e o agente.

## A grande mudança

- **O que mudou:** As cenas do Rive agora têm um caminho textual para agentes de programação. Um agente pode editar RML em uma pasta de projeto, enquanto o CLI compila um `.riv` para runtimes ou um `.rev` para continuar o trabalho no Editor.
- **Por que isso importa:** Designers e desenvolvedores de front-end ou jogos podem revisar alterações no código-fonte junto dos demais arquivos do projeto e usar verificações do CLI durante as iterações. Ainda precisam avaliar o design renderizado e as interações antes de usar o recurso em um produto.
- **O que acompanhar:** Levar um protótipo local para a web é uma decisão separada. Arquivos com scripts precisam de uma compilação assinada `--publish`; para uma compilação limpa `.riv` também é necessário vincular a conta ao arquivo e ter um espaço de trabalho Cadet ou superior. Confira essas condições e o gráfico final antes da implantação.

## A lista de tarefas documentadas

1. **Confira o acesso e instale.** O Rive lista macOS em Apple Silicon, Linux x86\_64 e Windows como sistemas compatíveis. Seu [guia de primeiros passos](https://rive.app/docs/cli/getting-started) traz instruções de instalação separadas para Windows e macOS/Linux; siga as instruções atuais para Windows nessa página. Depois da instalação, execute `rive doctor`. A referência de comandos também documenta `rive --version`; registre a versão que você instalar, pois o software está em prévia. O anúncio do Rive de 11 de setembro dizia que o CLI seria gratuito e sem limites *durante o período de prévia*. Essa declaração datada não define um preço permanente para o CLI. A [tabela atual de planos](https://rive.app/pricing) trata das contas do Rive e do Agent integrado ao Editor; confira as condições atuais antes de publicar.
2. **Crie um projeto de texto e abra a pré-visualização.** `rive create myproject` cria `scene.rml`, `rive.yaml`, instruções para o agente em `AGENTS.md` e `CLAUDE.md`, além de um `.gitignore`. Execute `rive myproject` em um terminal. Segundo o Rive, ele monitora a pasta, recompila quando há salvamentos e grava `myproject/build/myproject.riv`. A cena inicial tem uma prancheta, uma linha do tempo e uma máquina de estados, mas ainda não contém desenhos. A pré-visualização inicial é um retângulo escuro.
3. **Dê a pasta do projeto a um agente de programação e uma tarefa de design específica.** O [guia de agentes de IA](https://rive.app/docs/cli/agents) do Rive cita Claude Code, Cursor ou outro agente capaz de ler e gravar arquivos e executar comandos no shell. As instruções geradas ensinam o agente a usar `rive docs` e `rive schema` para encontrar objetos e propriedades compatíveis. RML é XML: elementos representam tipos do Rive, atributos representam suas propriedades e o aninhamento conecta objetos. O agente também pode editar `.luau` scripts, `.wgsl` shaders e recursos do projeto. Peça que trabalhe por etapas para você poder redirecionar o layout e o comportamento enquanto a pré-visualização é atualizada.
4. **Confira a compilação e o conteúdo do projeto.** Peça ao agente para executar `rive myproject --verify`, que compila sem gravar um arquivo `.riv`, e `rive inspect myproject --summary`, que informa problemas e a quantidade de objetos. A inspeção da cena completa e resolvida pode ser feita com `rive inspect myproject --json`. Se o projeto precisar de um arquivo local distribuível sem abrir a pré-visualização, `rive myproject --once` grava um arquivo `.riv` sem assinatura. Essas verificações podem detectar erros de compilação e objetos de cena ausentes ou inesperados. O [guia de RML do Rive](https://rive.app/docs/runtimes/advanced-topic/rml) alerta que uma compilação limpa não comprova que o gráfico tenha a aparência ou o comportamento pretendidos.
5. **Capture os estados que importam.** `rive myproject --screenshot=out.png` renderiza um PNG sem abrir uma janela. Os [exemplos](https://rive.app/docs/cli/examples) do Rive usam `--advance=1s` para obter um quadro após o início da animação, `--viewport=390x844` para escolher o tamanho do layout, `--data=battery/level=100` para inserir dados vinculados e `--pointer=click@120,60 --advance=20` para simular um clique. Escolha valores e coordenadas com base na sua cena. Compare capturas entre estados e tamanhos de janela e depois examine-as. Uma captura sem `--advance` mostra a pose inicial criada pelo autor; ela não é necessariamente o primeiro quadro da animação.
6. **Execute testes de scripts quando o projeto os incluir.** `rive myproject --test` executa os scripts Luau do projeto `Tests`. O Rive documenta `--verify --format=json` e `--test --format=json` para verificações automatizadas; compilações e testes com falha retornam códigos de saída diferentes de zero. Um agente pode usar esses relatórios para revisar o código-fonte. Os testes cobrem apenas as afirmações que foram escritas; examine também as interações que ficaram de fora.
7. **Escolha o fluxo de conta quando o protótipo local estiver pronto.** Um `.riv` é o recurso de runtime; um `.rev` abre para edição no Rive Editor. Segundo o Rive, criação local, pré-visualização, verificação, testes e capturas de tela funcionam sem login e off-line. É necessário `rive login` para `--publish`, `--rev`, `rive push`, `rive pull` e para importar um arquivo de conta remoto. Para começar com um backup exportado do Editor, `rive create myproject --from-rev=myfile.rev` funciona sem login. Para começar com um arquivo de conta, use `rive create myproject --from-remote-file` depois de entrar na conta. Esse comando vincula o projeto ao arquivo: `rive push myproject` envia uma revisão; `rive pull myproject` traz para o computador as alterações do Editor e **substitui a cena, os scripts e os recursos locais** após confirmação. Revise as alterações locais antes de puxar as mudanças.
8. **Confira os limites de assinatura e exportação antes de publicar.** `rive myproject --publish` grava um arquivo assinado `.riv` e exige login. Segundo o Rive, os runtimes da web e sua CDN rejeitam scripts sem assinatura; portanto, arquivos com scripts destinados à web devem seguir esse fluxo. `--publish` pode adicionar uma marca-d'água. A [referência de comandos](https://rive.app/docs/cli/reference/commands) do Rive diz que uma compilação limpa `.riv` exige que o projeto esteja vinculado a um arquivo de conta por meio de `rive push` e que o arquivo esteja em um espaço de trabalho Cadet ou superior. A condição da marca-d'água se aplica mesmo que a cena não tenha scripts. `--rev=<path>` também exige login e pode ser usada junto com `--once` ou `--publish`; grava um arquivo do Editor, não um substituto para runtime. Confira o plano atual da conta e o resultado efetivamente exportado antes da implantação.

O Rive também tem um [Agente de IA integrado ao Editor](https://rive.app/docs/editor/ai-agent). Ele é aberto na barra lateral do Editor e está sujeito ao plano do Editor e aos termos de créditos de IA. O fluxo desta orientação usa um agente de programação em conjunto com o CLI e uma pasta; as duas opções de agente têm interfaces e contextos de cobrança diferentes.

## Fontes e leitura complementar

- [Visão geral do Rive CLI](https://rive.app/docs/cli/overview) explica o fluxo pelo terminal, os formatos de saída, a pré-visualização e a troca de arquivos de conta.
- [Primeiros passos](https://rive.app/docs/cli/getting-started) apresenta sistemas compatíveis, instalação, conteúdo inicial do projeto, compilação local e condições de login.
- [Trabalhar com agentes de IA](https://rive.app/docs/cli/agents) mostra como um agente de programação usa as instruções geradas para o projeto e o retorno do CLI. O [guia do Agente integrado ao Editor](https://rive.app/docs/editor/ai-agent) descreve a interface separada do Editor.
- [Guia de RML](https://rive.app/docs/runtimes/advanced-topic/rml), [referência de comandos](https://rive.app/docs/cli/reference/commands) e [exemplos](https://rive.app/docs/cli/examples) comprovam o modelo de arquivos, os comandos exatos, o comportamento dos testes e das capturas e os limites de publicação.
- [Anúncio da equipe de 11 de setembro](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) data a prévia técnica e a declaração temporária de que o CLI seria gratuito. [Downloads](https://rive.app/downloads) atualmente classifica o CLI como Acesso Antecipado; [preços](https://rive.app/pricing) lista os planos de conta. Assista ao [vídeo demonstrativo do Rive](https://youtu.be/Y3E33otHeLE) para ver o fluxo entre pessoa e agente.

## Sources

- [Visão geral do Rive CLI](https://rive.app/docs/cli/overview) — Define o propósito do CLI, as saídas locais .riv e do Editor .rev, a pré-visualização ao vivo, recursos de inspeção, testes e capturas, e a troca remota de arquivos.
- [Primeiros passos do Rive CLI](https://rive.app/docs/cli/getting-started) — Documenta plataformas compatíveis, instalação, estrutura inicial do projeto, saída da pré-visualização, arquivos .rev, importação remota, exigências de login, assinatura de scripts e condições de marca-d'água.
- [Trabalhar com agentes de IA](https://rive.app/docs/cli/agents) — Documenta o uso com agentes externos de programação, instruções geradas para agentes, consulta de referência, verificação, inspeção e orientação humana por etapas.
- [Rive Markup Language](https://rive.app/docs/runtimes/advanced-topic/rml) — Define a estrutura RML, a compilação de projetos de texto e as verificações separadas de compilação, inspeção e visualização; afirma explicitamente que uma compilação limpa não comprova o comportamento ou a aparência pretendidos.
- [Referência de comandos do Rive CLI](https://rive.app/docs/cli/reference/commands) — Referência principal para comandos e opções precisos, códigos de saída, envio e recebimento remoto, autenticação da conta, assinatura, exportação .rev e requisitos para uma compilação .riv limpa.
- [Exemplos do Rive CLI](https://rive.app/docs/cli/examples) — Mostram capturas de tela sem interface gráfica, avanço da animação, janela de visualização, entrada de dados e ponteiro, testes Luau e relatórios JSON. Os exemplos estão documentados, não foram executados pela BIG CHANGE.
- [Agente de IA do Rive](https://rive.app/docs/editor/ai-agent) — Descreve o Agente separado, integrado ao Editor do Rive, e seu contexto de planos e créditos de IA.
- [Downloads do Rive](https://rive.app/downloads) — A página atual lista o CLI do Rive como Acesso Antecipado.
- [Preços do Rive](https://rive.app/pricing) — Lista as condições atuais dos planos de conta e do Agente do Editor; é tratada separadamente da declaração datada sobre os preços do CLI durante a prévia.
- [Apresentação do Rive CLI e do RML](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) — Comunicado da equipe do Rive que apresenta a versão como prévia técnica e diz que o CLI será gratuito e sem limites durante a prévia. Também explica as funções de .riv, .rev e RML e inclui um link para um vídeo demonstrativo.
- [Vídeo demonstrativo do Rive CLI](https://youtu.be/Y3E33otHeLE) — Link de vídeo fornecido pelo proprietário e incluído no corpo e nas fontes; não são feitas afirmações específicas sobre cenas ou resultados do vídeo.