Markdown edition

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

# Praktikal na gabay sa Rive CLI at mga coding agent

> Praktikal na gabay sa paggamit ng Rive CLI at RML kasama ang coding agent para gumawa, magsuri at sumubok ng interaktibong graphics, pati mga limitasyon sa account, pagpirma at pag-export.

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.

Hinahayaan ng bagong CLI ng Rive na gumawa ang coding agent ng interaktibong graphics bilang mga project file. Maaari itong magsulat ng Rive Markup Language (RML), Luau script at shader, saka utusan ang CLI na mag-compile, magsiyasat, sumubok at mag-render ng resulta. Maaaring panoorin ng tao ang lokal na preview at baguhin ang disenyo. Ipinakilala ng mga tauhan ng Rive ang CLI bilang isang **teknikal na preview noong Setyembre 11**; [inililista ito sa Downloads page ng Rive](https://rive.app/downloads), na sinuri noong Setyembre 27, sa ilalim ng **Early Access**.

Sinusunod ng checklist na ito ang [dokumentasyon ng Rive](https://rive.app/docs/cli/overview). Dokumentasyon lamang ang sinuri ng BIG CHANGE. Hindi namin in-install ang CLI, gumawa ng file o sumubok ng graphic na nilikha ng agent. Ipinakikita ng [video walkthrough ng Rive](https://youtu.be/Y3E33otHeLE) ang nilalayong proseso ng tao at agent.

## Ang malaking pagbabago

- **Ano ang nagbago:** Mayroon na ngayong text-based na paraan ang mga Rive scene para magamit ng mga coding agent. Maaaring baguhin ng agent ang RML sa loob ng project folder, habang kino-compile ng CLI ang `.riv` para sa mga runtime o ang `.rev` para sa karagdagang pag-edit sa Editor.
- **Bakit ito mahalaga:** Maaaring suriin ng mga designer at front-end o game developer ang mga pagbabago sa source kasabay ng iba nilang project file at gumamit ng CLI check habang umuulit sa pagdidisenyo. Kailangan pa rin nilang suriin ang na-render na disenyo at mga interaksiyon bago gamitin ang asset sa produkto.
- **Ano ang dapat bantayan:** Hiwalay na pasya ang paglipat ng lokal na prototype sa web. Kailangan ng pirmadong `--publish` build ang mga file na may script; kailangan din ng malinis na `.riv` na naka-link ang project sa account file at nasa workspace na Cadet o mas mataas. Suriin ang mga kondisyong iyon at ang pinal na graphic bago ito i-deploy.

## Listahan ng mga hakbang ayon sa dokumentasyon

1. **Tingnan ang akses at mag-install.** Inililista ng Rive bilang suportado ang macOS sa Apple Silicon, Linux x86\_64 at Windows. Nagbibigay ang [Getting Started guide](https://rive.app/docs/cli/getting-started) nito ng magkakahiwalay na tagubilin sa installer para sa Windows at macOS/Linux; sundin ang kasalukuyang tagubilin para sa Windows sa pahinang iyon. Patakbuhin ang `rive doctor` pagkatapos mag-install. Inilalarawan din sa command reference ang `rive --version`; itala ang aktuwal na bersiyong in-install dahil preview software pa ito. Sinabi sa anunsyo ng Rive noong Setyembre 11 na walang limitasyon at libre ang CLI *habang nasa preview*. Hindi pinatutunayan ng pahayag na may petsang iyon na permanente ang presyo ng CLI. Tumutukoy ang [kasalukuyang talahanayan ng mga plan](https://rive.app/pricing) sa mga account ng Rive at built-in na Editor Agent, kaya tingnan ang kasalukuyang mga tuntunin bago maglathala.
2. **Gumawa ng text project at buksan ang preview.** `rive create myproject` gumagawa ng `scene.rml`, `rive.yaml`, mga tagubilin para sa agent sa `AGENTS.md` at `CLAUDE.md`, at `.gitignore`. Patakbuhin ang `rive myproject` sa iisang terminal. Ayon sa Rive, binabantayan nito ang folder, muling binubuo ang proyekto kapag nagse-save at isinusulat ang `myproject/build/myproject.riv`. May artboard, timeline at state machine ang panimulang scene pero wala pang guhit. Maitim na parihaba ang unang preview.
3. **Ibigay sa coding agent ang project folder at tiyak na gawaing pangdisenyo.** Inililista sa [gabay ng Rive para sa AI Agent](https://rive.app/docs/cli/agents) na maaaring gamitin ang Claude Code, Cursor o ibang agent na nakakabasa at nakasusulat ng mga file at nagpapatakbo ng shell command. Itinuturo ng nilikhang tagubilin sa agent kung paano gamitin ang `rive docs` at `rive schema` upang makita ang mga suportadong object at property. XML ang RML: kumakatawan sa mga uri ng Rive ang mga element, katangian naman ng mga ito ang mga attribute, at pinag-uugnay ng nesting ang mga object. Maaari ring baguhin ng agent ang mga `.luau` script, `.wgsl` shader at asset ng proyekto. Hilingin dito na magtrabaho nang paisa-isang yugto upang maiwasto mo ang layout at asal habang nag-a-update ang preview.
4. **Suriin ang build at laman nito.** Hilingin sa agent na patakbuhin ang `rive myproject --verify`, na nagko-compile nang hindi nagsusulat ng `.riv`, at ang `rive inspect myproject --summary`, na nag-uulat ng mga problema at bilang ng object. May dokumentasyon para sa buong resolved scene sa `rive inspect myproject --json`. Kung kailangan ng proyekto ng maipamamahaging lokal na file nang hindi binubuksan ang preview, isinusulat ng `rive myproject --once` ang unsigned na `.riv`. Nakakakita ang mga pagsusuring ito ng error sa compilation at nawawala o di-inaasahang object sa scene. [Nagbababala ang gabay ng Rive sa RML](https://rive.app/docs/runtimes/advanced-topic/rml) na hindi pinatutunayan ng malinis na build na tama ang itsura o asal ng graphic.
5. **Kumuha ng capture sa mga mahalagang estado.** `rive myproject --screenshot=out.png` nagre-render ng PNG nang walang window. Ang [mga halimbawa](https://rive.app/docs/cli/examples) ay gumagamit ng `--advance=1s` para sa frame matapos magsimula ang animation, `--viewport=390x844` para sa piniling laki ng layout, `--data=battery/level=100` para sa naka-bind na datos at `--pointer=click@120,60 --advance=20` para sa ginayang pag-click. Pumili ng mga value at coordinate mula sa sarili mong scene. Ihambing ang mga capture sa iba-ibang estado at laki ng viewport, saka ikaw mismo ang magsiyasat sa mga ito. Ang capture na walang `--advance` ay ang orihinal na nakapahingang pose; hindi ito nangangahulugang unang frame ng pambungad na animation.
6. **Patakbuhin ang mga script test kung mayroon ang proyekto.** `rive myproject --test` nagpapatakbo sa mga `Tests` script ng proyekto. Inilalarawan ng Rive ang `--verify --format=json` at `--test --format=json` para sa mga awtomatikong pagsusuri; nagbabalik ng exit code na hindi sero ang pumalyang build at test. Maaaring gamitin ng agent ang mga ulat na iyon upang baguhin ang source. Mga assertion lamang na aktuwal na naisulat ang saklaw ng mga test, kaya suriin din ang mga interaksiyong hindi nila nasasaklaw.
7. **Piliin ang paraan ng account kapag handa na ang lokal na prototype.** Ang `.riv` ang asset na ginagamit sa runtime; ang `.rev` ay binubuksan para i-edit sa Rive Editor. Sinasabi ng Rive na maaaring gumawa, mag-preview, mag-beripika, sumubok at kumuha ng screenshot nang naka-sign out at offline. Kailangan ang `rive login` para sa `--publish`, `--rev`, `rive push`, `rive pull` at pag-import ng remote account file. Para magsimula sa na-export na backup ng Editor, `rive create myproject --from-rev=myfile.rev` gumagana nang hindi nagla-login. Para magsimula sa account file, gamitin ang `rive create myproject --from-remote-file` pagkatapos mag-login. Iniuugnay ng huli ang proyekto sa file na iyon: `rive push myproject` nag-a-upload ng rebisyon; `rive pull myproject` kinukuha ang mga pagbabago mula sa Editor at **pinapalitan nito ang lokal na scene, script at asset** matapos humingi ng kumpirmasyon. Suriin ang mga lokal na pagbabago bago mag-pull.
8. **Suriin ang mga limitasyon sa pagpirma at pag-export bago ilabas.** `rive myproject --publish` nagsusulat ng pirmadong `.riv` at kailangan nito ng login. Sinasabi ng Rive na tinatanggihan ng web runtime at CDN nito ang unsigned na script, kaya kailangang gamitin ang paraang ito sa file na may script para sa web. `--publish` ay maaari ring magdagdag ng watermark. Ang [command reference](https://rive.app/docs/cli/reference/commands) ay nagsasaad na ang malinis na `.riv` ay nangangailangan na iugnay ang proyekto sa account file sa pamamagitan ng `rive push` at kailangang nasa workspace na Cadet o mas mataas ang file na iyon. Nalalapat ang watermark kahit walang script ang scene. `--rev=<path>` nangangailangan din ng login at maaari itong gamitin kasama ng `--once` o `--publish`; Editor file ang isinusulat nito, hindi pamalit na runtime file. Tingnan ang kasalukuyang plano ng account at aktuwal na na-export na resulta bago mag-deploy.

Mayroon ding [AI Agent na nakapaloob sa Editor ng Rive](https://rive.app/docs/editor/ai-agent). Binubuksan ito mula sa sidebar ng Editor at saklaw ng plano at tuntunin sa AI credit ng Editor. Gumagamit ang gabay na ito ng workflow sa folder at terminal, kasama ang coding agent at CLI; magkaiba ang interface at konteksto ng pagsingil ng dalawang paraan ng paggamit ng agent.

## Mga sanggunian at karagdagang babasahin

- [Pangkalahatang-ideya ng Rive CLI](https://rive.app/docs/cli/overview) ang nagpapaliwanag sa workflow sa terminal, mga format ng output, preview at palitan ng account file.
- [Getting Started](https://rive.app/docs/cli/getting-started) ang naglilista ng mga suportadong sistema, pag-install, laman ng scaffold, lokal na build at mga kondisyon sa pag-sign in.
- [Paggawa kasama ang AI Agent](https://rive.app/docs/cli/agents) ang nagpapakita kung paano ginagamit ng coding agent ang nilikhang tagubilin sa proyekto at feedback ng CLI. Inilalarawan sa [gabay sa built-in na Editor Agent](https://rive.app/docs/editor/ai-agent) ang hiwalay na interface ng Editor.
- [Gabay sa RML](https://rive.app/docs/runtimes/advanced-topic/rml), [command reference](https://rive.app/docs/cli/reference/commands) at [mga halimbawa](https://rive.app/docs/cli/examples) ang batayan para sa modelo ng file, eksaktong command, pagsubok, pagkuha ng capture at mga limitasyon sa paglalathala.
- [Anunsyo ng mga tauhan noong Setyembre 11](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) ang nagtatakda ng petsa ng teknikal na preview at pahayag na pansamantalang walang bayad ang CLI. [Downloads](https://rive.app/downloads) kasalukuyang naglalagay sa CLI sa Early Access; [pagpepresyo](https://rive.app/pricing) naman ang naglilista ng mga plano ng account. Panoorin ang [video walkthrough ng Rive](https://youtu.be/Y3E33otHeLE) para sa proseso ng tao at agent.

## Sources

- [Pangkalahatang-ideya ng Rive CLI](https://rive.app/docs/cli/overview) — Tinutukoy ang layunin ng CLI, lokal na output na .riv at output ng Editor na .rev, live preview, kakayahang magsiyasat/sumubok/kumuha ng capture at palitan ng remote na file.
- [Rive CLI Getting Started](https://rive.app/docs/cli/getting-started) — Inilalarawan ang mga suportadong platform, pag-install, scaffold ng proyekto, output ng preview, .rev at remote import, pangangailangan sa login, pagpirma ng script at mga kondisyon sa watermark.
- [Paggawa kasama ang AI Agent](https://rive.app/docs/cli/agents) — Inilalarawan ang paggamit kasama ang panlabas na coding agent, nilikhang tagubilin sa agent, paghahanap sa reference, beripikasyon, pagsisiyasat at paunti-unting paggabay ng tao.
- [Rive Markup Language](https://rive.app/docs/runtimes/advanced-topic/rml) — Ipinapaliwanag ang istruktura ng RML, compilation ng text project at magkakahiwalay na pagsusuri sa compile, inspect at biswal; tahasang sinasabi na hindi pinatutunayan ng malinis na build ang nilalayong asal o itsura.
- [Rive CLI Command Reference](https://rive.app/docs/cli/reference/commands) — Pangunahing sanggunian sa eksaktong command, flag, asal ng exit code, remote push/pull, pagpapatunay ng account, pagpirma, pag-export ng .rev at mga kahingian para sa malinis na .riv.
- [Mga halimbawa ng Rive CLI](https://rive.app/docs/cli/examples) — Nagpapakita ng headless screenshot, advance, viewport, data at input ng pointer, Luau test at JSON report; dokumentado lamang ang mga halimbawa at hindi pinatakbo ng BIG CHANGE.
- [Rive AI Agent](https://rive.app/docs/editor/ai-agent) — Inilalarawan ang hiwalay na built-in na Editor Agent ng Rive at konteksto ng plano at AI credit nito.
- [Rive Downloads](https://rive.app/downloads) — Inilalagay sa kasalukuyang pahina ang Rive CLI sa ilalim ng Early Access.
- [Pagpepresyo ng Rive](https://rive.app/pricing) — Inililista ang kasalukuyang mga tuntunin para sa account at plano ng Editor Agent; hiwalay ito sa may petsang pahayag tungkol sa presyo ng CLI habang nasa preview.
- [Ipinapakilala ang Rive CLI at RML](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) — Tinawag ng anunsyo ng mga tauhan ng Rive na teknikal na preview ang release at sinabing walang limitasyon at libre ang CLI habang nasa preview. Ipinapaliwanag din dito ang papel ng .riv/.rev/RML at may link sa walkthrough.
- [Walkthrough ng Rive CLI](https://youtu.be/Y3E33otHeLE) — Video link na ibinigay ng may-ari at kasama sa artikulo at mga sanggunian; walang pahayag tungkol sa partikular na eksena o resulta ng video.