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, consultada em 27 de setembro, o lista como Acesso Antecipado.

Esta lista segue a documentação do Rive. 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 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 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 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 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 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 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 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. 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