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

# Практичан водич кроз Rive CLI и програмерске агенте

> Практичан водич за коришћење алата Rive CLI и RML-а уз програмерског агента за израду, преглед и тестирање интерактивне графике, укључујући ограничења налога, потписивања и извоза.

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.

Нови Rive CLI омогућава програмерском агенту да ради на интерактивној графици као на пројектним датотекама. Агент може да пише у Rive Markup Language-у (RML), скриптама Luau и шејдерима, а затим затражи од CLI-ја да компајлира, прегледа, тестира и прикаже резултат. Особа може да прати локални преглед и дорађује дизајн. Запослени у компанији Rive представили су CLI као **технички пробни приказ 11. септембра**; [страница за преузимање Rive CLI-ја](https://rive.app/downloads), на којој смо проверили податке 27. септембра, наводи га у одељку **Early Access**.

Ова контролна листа прати [документацију компаније Rive](https://rive.app/docs/cli/overview). BIG CHANGE је прегледао само документацију. Нисмо инсталирали CLI, направили датотеку нити тестирали графику коју је направио агент. [Видео-приказ поступка компаније Rive](https://youtu.be/Y3E33otHeLE) показује предвиђени процес рада човека и агента.

## Суштинска промена

- **Шта се променило:** Rive сцене сада имају текстуални начин рада за програмерске агенте. Агент може да уређује RML у фасцикли пројекта, док CLI компајлира датотеку`.riv` за окружења за покретање или датотеку`.rev` за даљи рад у уређивачу Rive Editor-а.
- **Зашто је то важно:** Дизајнери и фронтенд програмери или програмери игара могу да прегледају измене изворног кода поред осталих датотека пројекта и да користе провере CLI-ја током дораде. И даље морају да процене приказани дизајн и интеракције пре него што употребе ресурс у производу.
- **На шта обратити пажњу:** Прелазак са локалног прототипа на веб засебна је одлука. Датотеке са скриптама морају да имају потписану `--publish` датотеку; за чисту `.riv` потребно је и повезивање са датотеком налога и радни простор нивоа Cadet или вишег. Проверите те услове и коначну графику пре објављивања.

## Документовани кораци

1. **Проверите приступ и инсталирајте алат.** Rive наводи подршку за macOS на Apple Silicon рачунарима, Linux x86\_64 и Windows. [Водич за почетак рада](https://rive.app/docs/cli/getting-started) садржи засебна упутства за инсталацију на Windows-у и macOS/Linux-у; пратите актуелна упутства за Windows на тој страници. Покрените `rive doctor` након инсталације. У референтном приручнику за команде описана је и команда `rive --version`; забележите верзију коју сте стварно инсталирали, јер је ово пробна верзија. У саопштењу од 11. септембра Rive је навео да је коришћење CLI-ја током пробног периода бесплатно и без ограничења *током пробног периода*. Та временски ограничена изјава не утврђује трајну цену CLI-ја. [Актуелна табела планова](https://rive.app/pricing) односи се на Rive налоге и уграђеног агента у уређивачу; пре објављивања проверите важеће услове.
2. **Направите текстуални пројекат и отворите преглед.** `rive create myproject` прави `scene.rml`, `rive.yaml`, упутства за агента у датотеци `AGENTS.md` и `CLAUDE.md`, као и `.gitignore`. Покрените `rive myproject` у једном терминалу. Према наводима компаније Rive, алат прати фасциклу, поново гради пројекат након чувања измена и уписује `myproject/build/myproject.riv`. Почетна сцена садржи радну површину, временску линију и машину стања, али још нема нацртаних елемената. Почетни приказ је таман правоугаоник.
3. **Дајте програмерском агенту фасциклу пројекта и конкретан задатак за дизајн.** У [водичу за AI агенте](https://rive.app/docs/cli/agents) се као примери наводе Claude Code, Cursor или други агент који може да чита и уписује датотеке и покреће команде љуске. Генерисана упутства објашњавају агенту како да користи `rive docs` и `rive schema` за проналажење подржаних објеката и својстава. RML је XML: елементи представљају типове Rive објеката, атрибути њихова својства, а угнежђивање повезује објекте. Агент може да уређује и `.luau` скрипте, `.wgsl` шејдере и ресурсе пројекта. Задајте му рад у фазама како бисте могли да усмерите распоред и понашање док се преглед ажурира.
4. **Проверите градњу пројекта и његов садржај.** Затражите од агента да покрене `rive myproject --verify`, која компајлира пројекат без уписивања датотеке `.riv`, и `rive inspect myproject --summary`, која приказује проблеме и број објеката. За целу разрешену сцену документована је команда `rive inspect myproject --json`. Ако је потребна локална датотека за испоруку, без отварања прегледа, команда `rive myproject --once` уписује непотписану датотеку `.riv`. Ове провере могу да открију грешке при компајлирању и сценске објекте који недостају или су неочекивани. [Rive-ов водич за RML](https://rive.app/docs/runtimes/advanced-topic/rml) упозорава да успешна градња не доказује да графика изгледа или се понаша како је замишљено.
5. **Снимите важна стања.** `rive myproject --screenshot=out.png` прави PNG без отварања прозора. У [примерима](https://rive.app/docs/cli/examples) се користи `--advance=1s` за кадар након почетка анимације, `--viewport=390x844` за одабрану величину распореда, `--data=battery/level=100` за повезане податке и `--pointer=click@120,60 --advance=20` за симулирани клик. Вредности и координате изаберите према сопственој сцени. Упоредите снимке различитих стања и величина приказа, а затим их сами прегледајте. Снимак без команде `--advance` приказује почетну позу сцене; то не мора бити први кадар анимације.
6. **Тестирајте скрипте ако их пројекат садржи.** `rive myproject --test` покреће Luau скрипте пројекта `Tests`. Rive документује команде `--verify --format=json` и `--test --format=json` за аутоматизоване провере; неуспешна градња и тестови враћају излазни код различит од нуле. Агент може да користи те извештаје за дораду кода. Тестови покривају само експлицитно написане провере, зато ручно прегледајте интеракције које нису обухваћене тестовима.
7. **Изаберите рад са налогом када локални прототип буде спреман.** Датотека `.riv` је ресурс за покретање; датотека `.rev` отвара се ради уређивања у Rive Editor-у. Rive наводи да локално прављење, преглед, провере, тестови и снимци екрана раде без пријаве и без интернета. `rive login` Пријава је потребна за `--publish`, `--rev`, `rive push`, `rive pull` и увоз датотеке са налога. Да бисте започели са извезеном резервном копијом уређивача, команда `rive create myproject --from-rev=myfile.rev` ради без пријаве. За почетак рада са датотеком налога, након пријаве употребите `rive create myproject --from-remote-file`. Тиме се пројекат повезује са том датотеком: команда `rive push myproject` отпрема нову ревизију; `rive pull myproject` преузима измене из уређивача, док команда **замењује локалну сцену, скрипте и ресурсе** након потврде. Пре преузимања проверите локалне измене.
8. **Пре објављивања проверите потписивање и ограничења извоза.** `rive myproject --publish` прави потписану датотеку `.riv` и захтева пријаву. Према Rive-у, веб окружења за покретање и његов CDN одбијају непотписане скрипте, па датотека са скриптама намењеним вебу мора да се извезе овим поступком. `--publish` може да дода водени жиг. У [референтном приручнику за команде](https://rive.app/docs/cli/reference/commands) пише да чиста датотека `.riv` захтева да пројекат буде повезан са датотеком налога преко команде `rive push` и да се та датотека налази у радном простору нивоа Cadet или вишег. Услов за водени жиг важи и ако сцена нема скрипте. `--rev=<path>` Такође захтева пријаву и може да се користи уз команду `--once` или `--publish`; уписује датотеку за уређивач, а не замену за ресурс за покретање. Пре објављивања проверите актуелни план налога и стварни извезени резултат.

Rive има и [AI агента уграђеног у уређивач](https://rive.app/docs/editor/ai-agent). Отвара се у бочној траци уређивача и подлеже условима плана уређивача и кредитима за вештачку интелигенцију. Овај водич описује рад са фасциклом и терминалом уз програмерског агента и CLI; два начина рада с агентом имају различите интерфејсе и услове наплате.

## Извори и додатна литература

- [Преглед алата Rive CLI](https://rive.app/docs/cli/overview) објашњава рад у терминалу, формате излаза, преглед и размену датотека са налогом.
- [Почетни водич](https://rive.app/docs/cli/getting-started) наводи подржане системе, инсталацију, садржај почетног пројекта, локалну градњу и услове за пријаву.
- [Рад са AI агентима](https://rive.app/docs/cli/agents) показује како програмерски агент користи генерисана упутства пројекта и повратне информације CLI-ја. [Водич за уграђеног агента у уређивачу](https://rive.app/docs/editor/ai-agent) описује засебан интерфејс уређивача.
- [Водич за RML](https://rive.app/docs/runtimes/advanced-topic/rml), [референтни приручник за команде](https://rive.app/docs/cli/reference/commands) и [примери](https://rive.app/docs/cli/examples) поткрепљују опис формата датотека, тачних команди, тестирања, снимања и ограничења објављивања.
- [Саопштење запослених од 11. септембра](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) датира технички пробни приказ и привремену понуду бесплатног CLI-ја. [Преузимања](https://rive.app/downloads) тренутно означавају CLI као Early Access; [цена](https://rive.app/pricing) наводи планове налога. [Видео-приказ поступка компаније Rive](https://youtu.be/Y3E33otHeLE) показује начин рада човека и агента.

## Sources

- [Преглед алата Rive CLI](https://rive.app/docs/cli/overview) — Описује намену CLI-ја, локалне излазне датотеке .riv и .rev за уређивач, преглед уживо, могућности анализе, тестирања и снимања и размену датотека са удаљеним налогом.
- [Почетни водич за Rive CLI](https://rive.app/docs/cli/getting-started) — Документује подржане платформе, инсталацију, садржај почетног пројекта, излаз прегледа, .rev и удаљени увоз, потребу за пријавом, потписивање скрипти и услове за водени жиг.
- [Рад са AI агентима](https://rive.app/docs/cli/agents) — Документује употребу спољних програмерских агената, генерисана упутства, претраживање референци, проверу, анализу и постепено усмеравање од стране човека.
- [Rive Markup Language](https://rive.app/docs/runtimes/advanced-topic/rml) — Дефинише структуру RML-а, превођење текстуалног пројекта и одвојене визуелне провере, анализу и градњу; изричито упозорава да успешна градња не потврђује предвиђени изглед или понашање.
- [Референтни приручник команди алата Rive CLI](https://rive.app/docs/cli/reference/commands) — Примарни извор за прецизне команде и заставице, излазне кодове, удаљено слање и преузимање, пријаву налога, потписивање, извоз .rev датотека и услове за чисту .riv датотеку.
- [Примери за Rive CLI](https://rive.app/docs/cli/examples) — Приказују снимке екрана без прозора, напредовање анимације, величину приказа, податке и унос показивача, Luau тестове и JSON извештаје; примери су документовани, али их BIG CHANGE није покретао.
- [Rive AI агент](https://rive.app/docs/editor/ai-agent) — Описује засебног AI агента уграђеног у уређивач и услове плана и кредита за вештачку интелигенцију.
- [Страница за преузимање Rive алата](https://rive.app/downloads) — На актуелној страници CLI је наведен у одељку Early Access.
- [Цене Rive услуга](https://rive.app/pricing) — Наводи актуелне услове планова за налоге и агента у уређивачу; ти услови се разликују од временски ограничене понуде за CLI током пробног периода.
- [Представљамо Rive CLI и RML](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) — Запослени компаније Rive у саопштењу називају издање техничким пробним приказом и наводе да је CLI током тог периода бесплатан и без ограничења. Објашњавају и улоге формата .riv, .rev и RML-а и упућују на видео-приказ поступка.
- [Видео-приказ поступка у алату Rive CLI](https://youtu.be/Y3E33otHeLE) — Видео-веза коју је доставио власник пројекта, наведена у тексту и изворима; не износе се тврдње о конкретним сценама или резултатима из видеа.