Edição Markdown

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 utilizar o Rive CLI e a Rive Markup Language (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 através de ficheiros 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 rever o design. A equipa do Rive apresentou o CLI como uma **pré-visualização técnica em 11 de setembro**; a [página de transferências do Rive](https://rive.app/downloads), consultada a 27 de setembro, classifica-o como **Acesso Antecipado**.

Esta lista segue a [documentação do Rive](https://rive.app/docs/cli/overview). A BIG CHANGE analisou apenas a documentação. Não instalámos o CLI, não criámos um ficheiro nem testámos um gráfico produzido por um agente. O [vídeo de demonstração](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 passam a poder ser criadas e editadas em texto por agentes de programação. Um agente pode editar RML numa pasta do projeto, enquanto o CLI compila um `.riv` para runtimes ou um `.rev` para continuar o trabalho no Editor.
- **Por que isso importa:** Designers e programadores de front-end ou de jogos podem rever as alterações ao código-fonte juntamente com os restantes ficheiros do projeto e utilizar verificações do CLI durante as iterações. Antes de utilizar o recurso num produto, continuam a ter de avaliar o design renderizado e as interações.
- **O que acompanhar:** Publicar na Web um protótipo local é uma decisão separada. Os ficheiros com scripts precisam de uma compilação assinada `--publish`; para uma compilação limpa `.riv` também exige que o projeto esteja associado a um ficheiro de conta e que este se encontre num espaço de trabalho Cadet ou superior. Verifique estas condições e o gráfico final antes da implementação.

## Lista de tarefas documentadas

1. **Confira o acesso e instale.** O Rive indica como sistemas compatíveis o macOS em computadores com Apple Silicon, o Linux x86\_64 e o Windows. O [guia de primeiros passos](https://rive.app/docs/cli/getting-started) apresenta instruções de instalação separadas para Windows e macOS/Linux; siga as instruções para Windows que constam da página. Depois da instalação, execute `rive doctor`. A referência de comandos também documenta `rive --version`; registe a versão efetivamente instalada, pois o software ainda está em fase de pré-visualização. No anúncio de 11 de setembro, o Rive afirmou que o CLI seria gratuito e sem limites *durante o período de pré-visualização*. Esta declaração, feita nessa data, não estabelece um preço permanente para o CLI. A [tabela atual de planos](https://rive.app/pricing) diz respeito às contas Rive e ao Agente de IA integrado no Editor; consulte as condições atuais antes de publicar.
2. **Crie um projeto textual 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` num terminal. Segundo o Rive, o CLI monitoriza a pasta, recompila sempre que há alterações guardadas e cria `myproject/build/myproject.riv`. A cena inicial inclui uma prancheta, uma linha temporal e uma máquina de estados, mas ainda não contém desenhos. A pré-visualização inicial mostra um retângulo escuro.
3. **Forneça a pasta do projeto a um agente de programação e atribua-lhe uma tarefa de design específica.** O [guia de agentes de IA](https://rive.app/docs/cli/agents) do Rive menciona o Claude Code, o Cursor ou outro agente capaz de ler e modificar ficheiros e executar comandos na shell. As instruções geradas ensinam o agente a utilizar `rive docs` e `rive schema` para encontrar objetos e propriedades compatíveis. RML é XML: os elementos representam tipos do Rive, os atributos representam as respetivas propriedades e o aninhamento liga os objetos. O agente também pode editar `.luau` scripts, `.wgsl` shaders e recursos do projeto. Peça-lhe que trabalhe por etapas para poder ajustar a disposição e o comportamento à medida que 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 criar um ficheiro `.riv`, e `rive inspect myproject --summary`, que comunica problemas e o número de objetos. A cena completa e resolvida pode ser inspecionada com `rive inspect myproject --json`. Se o projeto precisar de um ficheiro local distribuível sem abrir a pré-visualização, `rive myproject --once` guarda um ficheiro `.riv` sem assinatura. Estas verificações podem detetar erros de compilação e objetos de cena em falta ou inesperados. O [guia de RML do Rive](https://rive.app/docs/runtimes/advanced-topic/rml) alerta que uma compilação sem erros não comprova que o gráfico tenha o aspeto ou o comportamento pretendidos.
5. **Capture os estados relevantes.** `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 adequados à sua cena. Compare as capturas entre diferentes estados e tamanhos da janela e, depois, examine-as. Uma captura sem `--advance` mostra a pose de repouso definida pelo autor; não é necessariamente o primeiro fotograma 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 falhas devolvem códigos de saída diferentes de zero. Um agente pode utilizar esses relatórios para rever o código-fonte. Os testes cobrem apenas as afirmações que foram programadas; 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-se para edição no Rive Editor. Segundo o Rive, a criação local, a pré-visualização, a verificação, os testes e as capturas de ecrã funcionam sem iniciar sessão e sem ligação à Internet. É necessário `rive login` para `--publish`, `--rev`, `rive push`, `rive pull` e importar um ficheiro de conta remoto. Para começar com uma cópia de segurança exportada do Editor, `rive create myproject --from-rev=myfile.rev` funciona sem autenticação. Para começar com um ficheiro de conta, use `rive create myproject --from-remote-file` depois de iniciar sessão. Este comando associa o projeto ao ficheiro: `rive push myproject` envia uma revisão; `rive pull myproject` transfere para o computador as alterações do Editor e **substitui a cena, os scripts e os recursos locais** após a confirmação. Reveja as alterações locais antes de importar as alterações remotas.
8. **Confira os limites de assinatura e exportação antes de publicar.** `rive myproject --publish` guarda um ficheiro assinado `.riv` e exige autenticação. Segundo o Rive, os runtimes da web e a sua CDN rejeitam scripts sem assinatura; portanto, ficheiros com scripts destinados à web devem seguir esse fluxo. `--publish` pode adicionar uma marca de á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 associado a um ficheiro de conta através de `rive push` e que esse ficheiro se encontre num espaço de trabalho Cadet ou superior. A condição da marca de água aplica-se mesmo que a cena não tenha scripts. `--rev=<path>` também exige autenticação e pode ser usada junto com `--once` ou `--publish`; guarda um ficheiro do Editor, não um substituto para um recurso de runtime. Verifique o plano atual da conta e o resultado efetivamente exportado antes da implementação.

O Rive também tem um [Agente de IA integrado no Editor](https://rive.app/docs/editor/ai-agent). É aberto a partir da barra lateral do Editor e está sujeito ao plano do Editor e às condições de créditos de IA. Este guia descreve o fluxo de trabalho com uma pasta e um terminal, utilizando um agente de programação com o CLI; as duas opções de agente têm interfaces e modelos de faturação diferentes.

## Fontes e leitura complementar

- [Visão geral do Rive CLI](https://rive.app/docs/cli/overview) explica o fluxo de trabalho no terminal, os formatos de saída, a pré-visualização e a troca de ficheiros de conta.
- [Primeiros passos](https://rive.app/docs/cli/getting-started) apresenta os sistemas compatíveis, a instalação, o conteúdo inicial do projeto, a compilação local e os requisitos de autenticação.
- [Trabalhar com agentes de IA](https://rive.app/docs/cli/agents) mostra como um agente de programação utiliza 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 ficheiros, os comandos exatos, o comportamento dos testes e das capturas, e os limites de publicação.
- [Anúncio da equipa de 11 de setembro](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) data a pré-visualização técnica e a declaração temporária de que o CLI seria gratuito. [Transferências](https://rive.app/downloads) classifica atualmente o CLI como Acesso Antecipado; [preços](https://rive.app/pricing) apresenta os planos de conta. Veja o [vídeo de demonstração do Rive](https://youtu.be/Y3E33otHeLE) para conhecer o fluxo de trabalho entre a pessoa e o agente.

## Sources

- [Visão geral do Rive CLI](https://rive.app/docs/cli/overview) — Define o propósito do CLI, os ficheiros de saída locais .riv e do Editor .rev, a pré-visualização em direto, as funções de inspeção, teste e captura, e a troca remota de ficheiros.
- [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, ficheiros .rev, importação remota, exigências de autenticação, assinatura de scripts e condições de marca de á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 pré-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 receção remotos, autenticação da conta, assinatura, exportação .rev e requisitos para uma compilação .riv sem erros.
- [Exemplos do Rive CLI](https://rive.app/docs/cli/examples) — Mostram capturas de ecrã sem interface gráfica, avanço da animação, dimensões da janela de visualização, dados e posição do ponteiro, testes Luau e relatórios JSON. Os exemplos estão documentados, mas 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 o seu contexto de planos e créditos de IA.
- [Transferências 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é-visualização.
- [Apresentação do Rive CLI e do RML](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) — Comunicado da equipa do Rive que apresenta a versão como pré-visualização técnica e diz que o CLI será gratuito e sem limites durante a pré-visualização. Também explica as funções de .riv, .rev e RML e inclui um link para um vídeo de demonstração.
- [vídeo de demonstração 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.