Edisi Markdown

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

# Panduan praktis Rive CLI dan agen pengodean

> Panduan praktis menggunakan Rive CLI dan RML bersama agen pengodean untuk membuat, memeriksa, dan menguji grafika interaktif, termasuk batas akun, penandatanganan, dan ekspor.

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.

CLI baru Rive memungkinkan agen pengodean mengerjakan grafika interaktif sebagai berkas proyek. Agen dapat menulis Rive Markup Language (RML), skrip Luau, dan shader, lalu meminta CLI mengompilasi, memeriksa, menguji, dan merender hasilnya. Seseorang dapat melihat pratinjau lokal dan merevisi desain. Staf Rive memperkenalkan CLI ini sebagai **pratinjau teknis pada 11 September**; [halaman Unduhan Rive](https://rive.app/downloads), yang diperiksa pada 27 September, mencantumkannya di bagian **Akses Awal**.

Daftar periksa ini mengikuti [dokumentasi Rive](https://rive.app/docs/cli/overview). BIG CHANGE hanya meninjau dokumentasi. Kami tidak memasang CLI, membuat berkas, atau menguji grafika yang dihasilkan agen. [Video panduan Rive](https://youtu.be/Y3E33otHeLE) memperlihatkan proses yang dimaksud, dengan manusia dan agen bekerja bersama.

## Perubahan besar

- **Yang berubah:** Adegan Rive kini memiliki jalur berbasis teks untuk agen pengodean. Agen dapat mengedit RML di folder proyek, sementara CLI mengompilasinya menjadi berkas runtime `.riv` atau berkas `.rev` untuk pekerjaan lanjutan di Editor.
- **Mengapa ini penting:** Desainer dan pengembang front-end atau gim dapat meninjau perubahan sumber bersama berkas proyek lainnya serta memakai pemeriksaan CLI selama iterasi. Mereka tetap perlu menilai hasil render dan interaksi sebelum menggunakan aset dalam produk.
- **Yang perlu dicermati:** Memindahkan prototipe lokal ke web merupakan keputusan terpisah. Berkas dengan skrip memerlukan build `--publish`; build `.riv` yang bersih juga memerlukan pengaitan berkas akun dan ruang kerja Cadet atau lebih tinggi. Periksa persyaratan tersebut dan grafika akhir sebelum menerapkannya.

## Daftar tugas yang didokumentasikan

1. **Periksa akses dan pasang perangkat lunak.** Rive mencantumkan macOS pada Apple Silicon, Linux x86\_64, dan Windows sebagai sistem yang didukung. [Panduan Memulai](https://rive.app/docs/cli/getting-started) menyediakan petunjuk pemasangan terpisah untuk Windows dan macOS/Linux; ikuti petunjuk Windows terkini di halaman tersebut. Jalankan `rive doctor` setelah pemasangan. Referensi perintah juga mendokumentasikan `rive --version`; catat versi yang benar-benar Anda pasang karena perangkat lunak ini masih pratinjau. Pengumuman Rive pada 11 September menyatakan CLI gratis tanpa batas *selama masa pratinjau*. Pernyataan bertanggal itu tidak menetapkan harga CLI permanen. [Tabel paket terkini](https://rive.app/pricing) membahas akun Rive dan Editor Agent bawaan, jadi periksa ketentuan terbaru sebelum menerbitkan.
2. **Buat proyek teks dan buka pratinjau.** `rive create myproject` membuat `scene.rml`, `rive.yaml`, instruksi agen di `AGENTS.md` dan `CLAUDE.md`, serta berkas `.gitignore`. Jalankan `rive myproject` di satu terminal. Menurut Rive, CLI memantau folder, membangun ulang saat berkas disimpan, dan menulis `myproject/build/myproject.riv`. Adegan awal memiliki artboard, linimasa, dan mesin status, tetapi belum ada gambar. Pratinjau awalnya berupa persegi panjang gelap.
3. **Berikan folder proyek kepada agen pengodean beserta tugas desain yang spesifik.**Panduan [Agen AI](https://rive.app/docs/cli/agents) dari Rive menyebut Claude Code, Cursor, atau agen lain yang dapat membaca dan menulis berkas serta menjalankan perintah shell. Instruksi yang dihasilkan menjelaskan kepada agen cara menggunakan `rive docs` dan `rive schema` untuk menemukan objek dan properti yang didukung. RML adalah XML: elemen mewakili tipe Rive, atribut mewakili propertinya, dan penyarangan menghubungkan objek. Agen juga dapat mengedit `.luau` skrip, `.wgsl` shader dan aset proyek. Minta agen bekerja bertahap agar Anda dapat mengarahkan ulang tata letak dan perilaku sembari pratinjau diperbarui.
4. **Periksa build dan isinya.** Minta agen menjalankan `rive myproject --verify`, yang mengompilasi tanpa menulis berkas `.riv`, serta `rive inspect myproject --summary`, yang melaporkan masalah dan jumlah objek. Untuk adegan lengkap yang telah diselesaikan, dokumentasi menyebut `rive inspect myproject --json`. Jika proyek memerlukan berkas lokal yang dapat dibagikan tanpa membuka pratinjau, `rive myproject --once`menulis berkas `.riv` tanpa tanda tangan. Pemeriksaan ini dapat menemukan kesalahan kompilasi serta objek adegan yang hilang atau tidak terduga. [Panduan RML Rive](https://rive.app/docs/runtimes/advanced-topic/rml) memperingatkan bahwa build bersih tidak memastikan grafika terlihat atau berperilaku sesuai tujuan.
5. **Ambil gambar untuk keadaan yang penting.** `rive myproject --screenshot=out.png` merender PNG tanpa jendela. [Contoh Rive](https://rive.app/docs/cli/examples) menggunakan `--advance=1s` untuk bingkai setelah animasi dimulai, `--viewport=390x844` untuk ukuran tata letak yang dipilih, `--data=battery/level=100` untuk data terikat, dan `--pointer=click@120,60 --advance=20` untuk klik simulasi. Pilih nilai dan koordinat dari adegan Anda sendiri. Bandingkan hasil tangkapan di beberapa keadaan dan ukuran tampilan, lalu periksa sendiri. Hasil tangkapan tanpa `--advance` menampilkan pose awal yang dibuat; itu belum tentu bingkai pertama animasi pembuka.
6. **Jalankan uji skrip jika proyek memilikinya.** `rive myproject --test` menjalankan skrip Luau `Tests` proyek. Rive mendokumentasikan `--verify --format=json` dan `--test --format=json` untuk pemeriksaan otomatis; build dan pengujian yang gagal mengembalikan kode keluar bukan nol. Agen dapat memakai laporan tersebut untuk merevisi sumbernya. Pengujian hanya mencakup pernyataan yang benar-benar ditulis, jadi tinjau interaksi yang tidak dicakup oleh pengujian.
7. **Pilih jalur akun ketika prototipe lokal siap.** Berkas `.riv` adalah aset runtime; berkas `.rev` dibuka untuk diedit di Rive Editor. Rive menyatakan pembuatan lokal, pratinjau, verifikasi, pengujian, dan tangkapan layar dapat dilakukan tanpa masuk akun dan tanpa koneksi internet. `rive login` diperlukan untuk `--publish`, `--rev`, `rive push`, `rive pull` dan mengimpor berkas akun jarak jauh. Untuk memulai dari cadangan Editor yang diekspor, `rive create myproject --from-rev=myfile.rev`dapat digunakan tanpa masuk. Untuk memulai dari berkas akun, gunakan `rive create myproject --from-remote-file`setelah masuk. Cara kedua ini mengaitkan proyek dengan berkas itu: `rive push myproject`mengunggah revisi; `rive pull myproject`mengambil perubahan Editor dan **menimpa adegan, skrip, dan aset lokal** setelah konfirmasi. Tinjau perubahan lokal sebelum mengambil pembaruan.
8. **Periksa batas penandatanganan dan ekspor sebelum menerbitkan.** `rive myproject --publish` menulis berkas `.riv` bertanda tangan dan memerlukan masuk akun. Rive menyatakan runtime web dan CDN-nya menolak skrip tanpa tanda tangan, jadi berkas yang memuat skrip untuk web harus memakai jalur ini. `--publish`dapat menambahkan tanda air. [Referensi perintah Rive](https://rive.app/docs/cli/reference/commands) menyatakan build `.riv` yang bersih mensyaratkan proyek terhubung ke berkas akun melalui `rive push` dan berkas tersebut berada di ruang kerja Cadet atau lebih tinggi. Ketentuan tanda air tetap berlaku meskipun adegan tidak memiliki skrip. `--rev=<path>`juga memerlukan masuk akun dan dapat digunakan bersama `--once` atau `--publish`; perintah itu menulis berkas Editor, bukan pengganti aset runtime. Periksa paket akun terkini dan hasil ekspor yang sebenarnya sebelum menerapkan.

Rive juga memiliki [Agen AI bawaan di Editor](https://rive.app/docs/editor/ai-agent). Fitur ini dibuka dari bilah sisi Editor dan mengikuti ketentuan paket serta kredit AI Editor. Alur kerja folder dan terminal dalam panduan ini menggunakan agen pengodean yang dipasangkan dengan CLI; kedua jalur agen tersebut memiliki antarmuka dan konteks penagihan berbeda.

## Sumber & bacaan lanjutan

- [Ikhtisar Rive CLI](https://rive.app/docs/cli/overview) menjelaskan alur terminal, format keluaran, pratinjau, dan pertukaran berkas akun.
- [Panduan Memulai](https://rive.app/docs/cli/getting-started) menjelaskan sistem yang didukung, pemasangan, isi kerangka proyek, build lokal, dan syarat masuk akun.
- [Bekerja dengan Agen AI](https://rive.app/docs/cli/agents) menunjukkan cara agen pengodean menggunakan instruksi proyek yang dihasilkan dan umpan balik CLI. Panduan [Agen Editor bawaan](https://rive.app/docs/editor/ai-agent) menjelaskan antarmuka Editor yang terpisah.
- [Panduan RML](https://rive.app/docs/runtimes/advanced-topic/rml), [referensi perintah](https://rive.app/docs/cli/reference/commands), dan [contoh](https://rive.app/docs/cli/examples) mendukung uraian tentang model berkas, perintah yang tepat, pengujian, perilaku tangkapan, dan batas penerbitan.
- [Pengumuman staf pada 11 September](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) memberi tanggal pratinjau teknis dan pernyataan sementara bahwa CLI gratis. [Unduhan](https://rive.app/downloads) saat ini mencantumkan CLI sebagai Akses Awal; [harga](https://rive.app/pricing) mencantumkan paket akun. Tonton [video panduan Rive](https://youtu.be/Y3E33otHeLE) untuk melihat proses manusia dan agen.

## Sources

- [Ikhtisar Rive CLI](https://rive.app/docs/cli/overview) — Menjelaskan tujuan CLI, keluaran lokal .riv dan Editor .rev, pratinjau langsung, kemampuan inspeksi/uji/tangkapan, serta pertukaran berkas jarak jauh.
- [Panduan Memulai Rive CLI](https://rive.app/docs/cli/getting-started) — Mendokumentasikan platform yang didukung, pemasangan, kerangka proyek, keluaran pratinjau, .rev dan impor jarak jauh, kebutuhan masuk akun, penandatanganan skrip, dan ketentuan tanda air.
- [Bekerja dengan Agen AI](https://rive.app/docs/cli/agents) — Mendokumentasikan penggunaan bersama agen pengodean eksternal, instruksi agen yang dihasilkan, pencarian referensi, verifikasi, inspeksi, dan arahan manusia bertahap.
- [Rive Markup Language](https://rive.app/docs/runtimes/advanced-topic/rml) — Mendefinisikan struktur RML, kompilasi proyek teks, serta pemeriksaan kompilasi, inspeksi, dan visual yang terpisah; secara tegas menyebut build bersih tidak menjamin tampilan atau perilaku sesuai tujuan.
- [Referensi Perintah Rive CLI](https://rive.app/docs/cli/reference/commands) — Rujukan utama untuk perintah dan flag yang tepat, perilaku kode keluar, push/pull jarak jauh, autentikasi akun, penandatanganan, ekspor .rev, dan persyaratan .riv bersih.
- [Contoh Rive CLI](https://rive.app/docs/cli/examples) — Memperlihatkan tangkapan layar tanpa antarmuka, advance, viewport, data, masukan penunjuk, uji Luau, dan laporan JSON; contoh hanya didokumentasikan, tidak dijalankan oleh BIG CHANGE.
- [Agen AI Rive](https://rive.app/docs/editor/ai-agent) — Menjelaskan Agen Editor bawaan Rive yang terpisah serta konteks paket dan kredit AI-nya.
- [Unduhan Rive](https://rive.app/downloads) — Halaman terkini mencantumkan Rive CLI dalam Akses Awal.
- [Harga Rive](https://rive.app/pricing) — Mencantumkan ketentuan paket akun dan Editor Agent saat ini; diperlakukan terpisah dari pernyataan harga CLI sementara selama pratinjau.
- [Memperkenalkan Rive CLI dan RML](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) — Pengumuman staf Rive menyebut rilis ini sebagai pratinjau teknis dan mengatakan CLI gratis tanpa batas selama pratinjau. Pengumuman juga menjelaskan fungsi .riv/.rev/RML dan menautkan video panduan.
- [Video panduan Rive CLI](https://youtu.be/Y3E33otHeLE) — Tautan video yang diberikan pemilik, disertakan dalam isi dan sumber; artikel ini tidak membuat klaim khusus tentang adegan atau hasil dalam video.