cli

# Opaline CLI Opaline CLI ایک کمانڈ لائن ٹول ہے جو Claude Code اور OpenAI Codex سیشنز کو کیپچر کرتا ہے اور انہیں ٹیم تجزیات کے لیے Opaline پلیٹ فارم پر اپ لوڈ کرتا ہے۔ پروڈکشن API `https://opaline.so` پر میزبانی کی جاتی ہے۔ یہ پہلے `rudel` کے نام سے جانا جاتا تھا اور اس نام کے ساتھ مطابقت برقرار رکھتا ہے۔ ## فوری آغاز Node.js 20 یا نیا درکار ہے۔ کسی بھی ڈائریکٹری سے `npx opaline@latest` چلائیں۔ CLI مقامی Claude Code اور Codex سیشنز کو اسکین کرتا ہے، ریپوزٹری اور سیشن کی تعداد دکھاتا ہے، اور آپ کو انتخاب کرنے دیتا ہے کہ کون سی ریپوزٹریز اپ لوڈ کرنی ہیں اور سنک جاری رکھنا ہے۔ لاگ ان صرف انتخاب کے بعد کھلتا ہے۔ `pnpx opaline@latest` بھی کام کرتا ہے؛ عالمی انسٹال اختیاری ہے۔ Opaline ڈیمو سے کمانڈ کاپی کرنے سے ایک پوشیدہ `--code` ویلیو شامل ہوتی ہے۔ یہ ایک وقتی کوڈ آپ کے ٹرمینل کو براؤزر کے ساتھ جوڑتا ہے تاکہ لائیو انتخاب اور اپ لوڈ کی حیثیت دیکھی جا سکے۔ اگر استعمال نہ ہو تو یہ دس منٹ بعد ختم ہو جاتا ہے۔ اسی براؤزر میں لاگ ان کی منظوری دیں جہاں سے آپ نے کمانڈ کاپی کی تھی۔ پہلی بار اپ لوڈ براؤزر سیٹ اپ جاری رکھتے ہیں؛ واپس آنے والے صارفین اپنے ورک اسپیس کے سیشنز صفحہ کھولتے ہیں۔ خودکار اپ لوڈز بنڈل شدہ CLI کو `~/.rudel/runtime` کے تحت برقرار رکھتے ہیں اور آپ کے Node ایگزیکیوٹیبل کا استعمال کرتے ہیں، تاکہ عارضی رنر کیش ختم ہونے کے بعد بھی ہکس کام کرتے رہیں۔ `opaline login` براؤزر پر مبنی ڈیوائس فلو کھولتا ہے۔ `opaline upload` مقامی ورک ٹریز کو ریپوزٹری کے لحاظ سے گروپ کرتا ہے، آپ کو انتخاب کرنے دیتا ہے کہ کون سی ریپوزٹریز مطابقت پذیر رہیں، مطلوبہ Claude Code اور/یا Codex ہکس انسٹال کرتا ہے، اور نئے سیشنز اپ لوڈ کرتا ہے۔ ریپوزٹریز کو آن یا آف کرنے کے لیے وہی ٹیبل کھولیں۔ موجودہ `rudel` صارفین کو دوبارہ لاگ ان کرنے کی ضرورت نہیں ہے۔ Opaline جان بوجھ کر موجودہ `~/.rudel` اسناد اور اسٹیٹ ڈائریکٹری پڑھتا ہے، اور `rudel` پیکیج مطابقت کے عرف کے طور پر جاری رہتا ہے۔ `opaline upload` کسی بھی ڈائریکٹری سے چلائیں، بشمول آپ کی ہوم فولڈر۔ پکر مختلف ریپوزٹریز میں محفوظ سیشنز تلاش کرتا ہے اور آپ کے منتخب کردہ ریپوزٹریز کو اپ لوڈ کرتا ہے۔ یہ ان انتخابوں کے لیے خودکار اپ لوڈز بھی فعال کرتا ہے۔ Claude Code کا ہک آپ کی صارف کی ترتیبات میں انسٹال ہوتا ہے، لہذا سیٹ اپ آپ کی موجودہ ڈائریکٹری پر منحصر نہیں ہے۔ موجودہ ہکس اور ترتیبات محفوظ رہتی ہیں۔ ## عام ورک فلو `opaline upload` (یا `npx opaline@latest`) چلائیں تاکہ ریپوزٹری ٹیبل کھلے۔ ٹیبل اسکیننگ کے دوران بھرتا ہے، پھر مقامی اور پہلے سے اپ لوڈ شدہ سیشن کی تعداد کے ساتھ آن/آف ٹوگلز دکھاتا ہے۔ اسپیس ریپوزٹری تبدیل کرتا ہے؛ انٹر ایک جائزہ کھولتا ہے جس میں نئے شامل، پہلے سے فعال، اور غیر فعال شدہ ریپوزٹریز ہوتی ہیں۔ انٹر تصدیق کرتا ہے؛ Esc ترمیم پر واپس آتا ہے۔ اپ لوڈ کی پیشرفت اسی ٹیبل میں رہتی ہے۔ موجودہ Rudel ہکس فعال کے طور پر پہچانے جاتے ہیں۔ محفوظ کرنا ملکیتی ہکس کو Opaline میں منتقل کرتا ہے، ڈپلیکیٹ مقامی ہکس ہٹاتا ہے، اور غیر متعلقہ ایجنٹ ترتیبات محفوظ رکھتا ہے۔ Codex نوٹیفکیشن ٹولز خودکار اپ لوڈز کے ساتھ مل کر رہ سکتے ہیں۔ Opaline موجودہ کمانڈ اور دلائل برقرار رکھتا ہے، نوٹیفکیشن JSON آگے بھیجتا ہے، اور آزادانہ طور پر اپ لوڈ کرتا ہے۔ Codex Computer Use اپنی نوٹیفکیشن چین کے سامنے رہتا ہے۔ اپ لوڈز آف کرنے سے نوٹیفکیشنز کام کرتی رہتی ہیں۔ کسٹم اسکرپٹس محفوظ رہتی ہیں؛ Opaline ان اسکرپٹس کو دوبارہ نہیں لکھتا جو خود پرانے Rudel انسٹالیشنز کو کال کرتے ہیں۔ سیٹ اپ کی ناکامیاں اپنی مکمل تفصیلات اور دوبارہ کوشش/واپسی کا عمل دکھاتی ہیں، بشمول وہ سیٹنگز فائل جو Codex کنفیگریشن کے غلط ہونے پر درست کرنی ہے۔ ## کلیدی تصورات - **سیشنز:** Claude Code اور Codex JSONL ٹرانسکرپٹس جو مقامی مشین پر دریافت ہوتے ہیں۔ - **ہکس:** ایجنٹ لائف سائیکل کمانڈز جو `opaline upload` یا `opaline enable` کے ذریعے انسٹال ہوتے ہیں۔ ہکس بغیر ہیڈ کے چلتے ہیں، ریپوزٹری کی اجازت کی فہرست سے مشورہ کرتے ہیں، معروف خفیہ پیٹرن فلٹر کرتے ہیں، اور مکمل سیشن اپ لوڈ کرتے ہیں۔ - **تنظیمیں:** Opaline ورک اسپیس جو اپ لوڈز وصول کرتا ہے۔ کسی پروجیکٹ سے وابستہ تنظیم تبدیل کرنے کے لیے `opaline set-org` استعمال کریں۔ - **مقامی اسٹیٹ:** اسناد، دوبارہ کوشش کی قطاریں، لاگز، اور پروجیکٹ میپنگز مطابقت کے لیے `~/.rudel` میں رہتی ہیں۔ کسی اور ڈائریکٹری میں آپٹ ان کرنے کے لیے `OPALINE_CONFIG_DIR` سیٹ کریں؛ `RUDEL_CONFIG_DIR` اب بھی معاون ہے۔ - **مطابقت کا عرف:** `rudel` ایگزیکیوٹیبل اسی Opaline نفاذ کو غیر تبدیل شدہ دلائل، معیاری ان پٹ/آؤٹ پٹ، اور ایگزٹ اسٹیٹس کے ساتھ سونپتا ہے۔ اس کا واحد اضافہ ہر بار چلانے پر stderr پر ایک نام تبدیل کرنے کا نوٹس ہے۔