Markdown ایڈیشن

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 کا ڈاؤن لوڈ صفحہ](https://rive.app/downloads)، جسے 27 ستمبر کو دیکھا گیا، اسے **ابتدائی رسائی** میں درج کرتا ہے۔

یہ فہرست [Rive کی دستاویزات](https://rive.app/docs/cli/overview) کی پیروی کرتی ہے۔ BIG CHANGE نے صرف دستاویزات کا جائزہ لیا۔ ہم نے CLI نصب نہیں کیا، کوئی فائل نہیں بنائی اور ایجنٹ کے تیار کردہ گرافک کو نہیں آزمایا۔ Rive کی [ویڈیو رہنمائی](https://youtu.be/Y3E33otHeLE) انسان اور ایجنٹ کے مطلوبہ طریقۂ کار کو دکھاتی ہے۔

## بڑی تبدیلی

- **کیا بدلا:** اب Rive مناظر کے لیے کوڈنگ ایجنٹس کو متن پر مبنی راستہ ملتا ہے۔ ایجنٹ پروجیکٹ فولڈر میں RML میں ترمیم کرسکتا ہے، جبکہ CLI ایک `.riv` رن ٹائمز کے لیے مرتب کرتا ہے یا ایک `.rev` ایڈیٹر میں مزید کام کے لیے تیار کرتا ہے۔
- **اس کی اہمیت:** ڈیزائنرز اور فرنٹ اینڈ یا گیم ڈویلپرز ماخذ میں ہونے والی تبدیلیوں کا اپنے دوسرے پروجیکٹ فائلوں کے ساتھ جائزہ لے سکتے ہیں اور کام کے دوران CLI سے جانچ کر سکتے ہیں۔ پھر بھی، پروڈکٹ میں اثاثہ استعمال کرنے سے پہلے انہیں رینڈر شدہ ڈیزائن اور تعاملات خود پرکھنے ہوں گے۔
- **کن باتوں پر نظر رکھیں:** مقامی نمونے کو ویب پر منتقل کرنا ایک الگ فیصلہ ہے۔ اسکرپٹس والی فائلوں کے لیے دستخط شدہ `--publish` بلڈ درکار ہے؛ صاف `.riv` کے لیے اکاؤنٹ فائل سے ربط اور Cadet یا اس سے اعلیٰ درجے کی ورک اسپیس بھی چاہیے۔ تعیناتی سے پہلے ان شرائط اور آخری گرافک کو جانچیں۔

## دستاویزات پر مبنی کاموں کی فہرست

1. **رسائی اور تنصیب دیکھیں۔** Rive کے مطابق Apple Silicon والے macOS، Linux x86\_64 اور Windows معاون ہیں۔ اس کی [ابتدائی رہنما](https://rive.app/docs/cli/getting-started) Windows اور macOS/Linux کے لیے تنصیب کی الگ ہدایات فراہم کرتی ہے؛ صفحے پر موجود تازہ Windows ہدایات استعمال کریں۔ تنصیب کے بعد `rive doctor` چلائیں۔ کمانڈ ریفرنس میں `rive --version` بھی درج ہے؛ اپنا نصب کردہ ورژن نوٹ کریں، کیونکہ یہ پیش منظر والا سافٹ ویئر ہے۔ Rive کے 11 ستمبر کے اعلان کے مطابق CLI بلاحد مفت تھا *پیش منظر کی مدت کے دوران*۔ یہ تاریخ والا بیان CLI کی مستقل قیمت طے نہیں کرتا۔ [موجودہ پلان جدول](https://rive.app/pricing) Rive اکاؤنٹس اور بلٹ اِن Editor Agent سے متعلق ہے، اس لیے شائع کرنے سے پہلے موجودہ شرائط دیکھیں۔
2. **متنی پروجیکٹ بنائیں اور پیش منظر کھولیں۔** `rive create myproject` سے یہ فائلیں بنتی ہیں: `scene.rml`، `rive.yaml`، اور ایجنٹ کی ہدایات `AGENTS.md` اور `CLAUDE.md`، نیز `.gitignore`۔ `rive myproject` کو ایک ہی ٹرمینل میں چلائیں۔ Rive کے مطابق یہ فولڈر پر نظر رکھتا ہے، فائل محفوظ ہونے پر دوبارہ بلڈ کرتا ہے اور `myproject/build/myproject.riv`۔ ابتدائی منظر میں آرٹ بورڈ، ٹائم لائن اور اسٹیٹ مشین ہوتی ہے، لیکن ابھی اس پر کچھ بنایا نہیں گیا۔ ابتدائی پیش منظر ایک گہرا مستطیل ہوتا ہے۔
3. **کوڈنگ ایجنٹ کو پروجیکٹ فولڈر دیں اور ڈیزائن کا واضح کام بتائیں۔** Rive کی [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 رینڈر کرتا ہے۔ Rive کی [مثالوں](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` دستاویز کرتا ہے؛ ناکام بلڈ اور ٹیسٹ نان زیرو ایگزٹ کوڈ دیتے ہیں۔ ایجنٹ ان رپورٹس سے ماخذ میں ترمیم کرسکتا ہے۔ ٹیسٹ صرف لکھی گئی assertions جانچتے ہیں، اس لیے ان تعاملات کا بھی جائزہ لیں جنہیں ٹیسٹ شامل نہیں کرتے۔
7. **مقامی نمونہ تیار ہو تو اکاؤنٹ والا طریقہ اختیار کریں۔** ایک `.riv` رن ٹائم اثاثہ ہے؛ ایک `.rev` Rive Editor میں ترمیم کے لیے کھلتا ہے۔ Rive کے مطابق مقامی تخلیق، پیش منظر، تصدیق، ٹیسٹ اور اسکرین شاٹس لاگ اِن اور انٹرنیٹ کے بغیر کام کرتے ہیں۔ `rive login` درکار ہے `--publish`، `--rev`، `rive push`، `rive pull` اور دور دراز اکاؤنٹ فائل درآمد کرنے کے لیے۔ Editor کے برآمد کردہ بیک اپ سے شروع کرنے کے لیے `rive create myproject --from-rev=myfile.rev` لاگ اِن کے بغیر کام کرتا ہے۔ اکاؤنٹ فائل سے شروع کرنے کے لیے، لاگ اِن کے بعد `rive create myproject --from-remote-file` استعمال کریں۔ یہ طریقہ پروجیکٹ کو اس فائل سے جوڑتا ہے: `rive push myproject` ایک نیا نظرثانی ورژن اپ لوڈ کرتا ہے؛ `rive pull myproject` Editor کی تبدیلیاں مقامی پروجیکٹ میں لاتا ہے اور **مقامی منظر، اسکرپٹس اور اثاثوں کو مقامی ورژن پر لکھ دیتا ہے** تصدیق کے بعد۔ pull کرنے سے پہلے مقامی تبدیلیوں کا جائزہ لیں۔
8. **اشاعت سے پہلے دستخط اور ایکسپورٹ کی حدود دیکھیں۔** `rive myproject --publish` دستخط شدہ `.riv` لکھتا ہے اور لاگ اِن درکار ہے۔ Rive کے مطابق ویب رن ٹائمز اور اس کا CDN بغیر دستخط والی اسکرپٹس رد کرتے ہیں، اس لیے ویب کے لیے اسکرپٹس والی فائل اسی راستے سے بنائیں۔ `--publish` واٹرمارک شامل کرسکتا ہے۔ Rive کا [کمانڈ ریفرنس](https://rive.app/docs/cli/reference/commands) بتاتا ہے کہ صاف `.riv` کے لیے پروجیکٹ کو اکاؤنٹ فائل سے منسلک ہونا چاہیے، اس کے لیے `rive push` اور وہ فائل Cadet یا اس سے اعلیٰ درجے کی ورک اسپیس میں ہونی چاہیے۔ واٹرمارک کی شرط اس وقت بھی لاگو ہوتی ہے جب منظر میں کوئی اسکرپٹ نہ ہو۔ `--rev=<path>` کے لیے بھی لاگ اِن درکار ہے اور اسے `--once` یا `--publish` کے ساتھ استعمال کیا جاسکتا ہے؛ یہ Editor فائل لکھتا ہے، رن ٹائم متبادل نہیں۔ تعیناتی سے پہلے موجودہ اکاؤنٹ پلان اور برآمد شدہ نتیجہ دیکھیں۔

Rive کے Editor میں ایک [بلٹ اِن AI Agent](https://rive.app/docs/editor/ai-agent) بھی ہے۔ یہ Editor کے سائڈبار سے کھلتا ہے اور Editor کے پلان اور AI کریڈٹ کی شرائط کے تابع ہے۔ اس رہنما کا فولڈر اور ٹرمینل والا طریقۂ کار CLI کے ساتھ کوڈنگ ایجنٹ استعمال کرتا ہے؛ دونوں راستوں کے انٹرفیس اور بلنگ کی شرائط الگ ہیں۔

## ماخذ اور مزید مطالعہ

- [Rive CLI کا جائزہ](https://rive.app/docs/cli/overview) ٹرمینل کا طریقۂ کار، آؤٹ پٹ فارمیٹس، پیش منظر اور اکاؤنٹ فائل کے تبادلے کی وضاحت کرتا ہے۔
- [ابتدائی رہنما](https://rive.app/docs/cli/getting-started) معاون نظام، تنصیب، ابتدائی پروجیکٹ کے اجزا، مقامی بلڈ اور سائن اِن کی شرائط بتاتی ہے۔
- [AI ایجنٹس کے ساتھ کام](https://rive.app/docs/cli/agents) دکھاتا ہے کہ کوڈنگ ایجنٹ تیار کردہ پروجیکٹ ہدایات اور CLI کی آراء کیسے استعمال کرتا ہے۔ [بلٹ اِن Editor Agent کی رہنمائی](https://rive.app/docs/editor/ai-agent) الگ Editor انٹرفیس کی وضاحت کرتی ہے۔
- [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 عارضی طور پر مفت اور بلاحد تھا۔ اس میں .riv، .rev، RML کے کردار بھی بیان اور ایک ویڈیو رہنمائی سے ربط دیا گیا ہے۔ [ڈاؤن لوڈز](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 اور Editor کی .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) — ہیڈ لیس اسکرین شاٹس، advance، viewport، data اور pointer input، Luau ٹیسٹ اور JSON رپورٹس دکھاتی ہیں؛ BIG CHANGE نے یہ مثالیں نہیں چلائیں۔
- [Rive AI Agent](https://rive.app/docs/editor/ai-agent) — Rive کے الگ بلٹ اِن Editor Agent اور اس کے پلان اور AI کریڈٹ کے سیاق کی وضاحت کرتا ہے۔
- [Rive کے ڈاؤن لوڈز](https://rive.app/downloads) — موجودہ صفحہ Rive CLI کو Early Access کے تحت درج کرتا ہے۔
- [Rive کی قیمتیں](https://rive.app/pricing) — موجودہ اکاؤنٹ اور Editor Agent پلان کی شرائط درج کرتی ہیں؛ انہیں تاریخ والے 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) — مالک کی فراہم کردہ ویڈیو کا ربط، جو مضمون اور ماخذ میں شامل ہے؛ ویڈیو کے کسی مخصوص منظر یا نتیجے کے بارے میں دعویٰ نہیں کیا گیا۔