آخر کار آپ کی مطلوبہ چیز آ گئی! رالف TUI، رالف لوپ کا بصری مظاہرہ

# آخر کار آپ کی مطلوبہ چیز آ گئی! رالف TUI، رالف لوپ کا بصری مظاہرہ میں نے پہلے **ralph-loop** کے بارے میں ایک ٹیوٹوریل لکھا تھا، بہت سے دوستوں نے اسے چلانے کے بعد یکساں رائے دی: **مزہ تو آ رہا ہے، آخر کار کلاڈ کوڈ طویل عرصے تک چل سکتا ہے۔** لیکن بعض اوقات آپ دیکھتے ہیں کہ یہ بالکل ساکت ہے، تو آپ کے دل میں خدشہ پیدا ہوتا ہے: "کیا یہ آگے بڑھ رہا ہے، یا وہیں گھوم رہا ہے؟" یہی وجہ ہے کہ میں نے حال ہی میں **ralph-tui** پر کام شروع کیا۔  **ralph-tui کلاڈ کوڈ کے ساتھ جبری طور پر منسلک نہیں ہے، یہ رالف لوپ کے جوہر کو وراثت میں لیتا ہے اور اسے تیار کرتا ہے، اور ٹاسک کی انجام دہی اور عمل کو بصری بناتا ہے، جس سے بڑے ماڈلز کے طویل عرصے تک کام کرنے کی حد بہت کم ہو جاتی ہے۔** آپ مکمل طور پر دوسرے ایجنٹ، دوسرے ماڈلز، ملکی، سستے، جنہیں آپ طویل عرصے تک چلا سکتے ہیں، استعمال کر سکتے ہیں۔ رالف-ٹی یو آئی کے ساتھ، ہم عام لوگوں کے لیے، اس کی اہمیت مینوئل سے آٹومیٹک اور کروز کنٹرول والی گاڑی میں تبدیل ہونے سے کم نہیں ہے۔ ## یہ آخر ہے کیا؟ آپ رالف-ٹی یو آئی کو "**AI کوڈنگ ایجنٹ کا لوپ آرکیسٹریٹر**" سمجھ سکتے ہیں، لیکن یہ صرف "چلنے کے قابل" ہونے پر مطمئن نہیں ہے، بلکہ اس بات پر زیادہ توجہ دیتا ہے کہ "**آپ دیکھ سکیں، کنٹرول کر سکیں، اور بحال کر سکیں**"۔ اس کا بنیادی طریقہ کار بہت سادہ ہے: - آپ اسے بہت سارے ٹاسک دیتے ہیں (پی آر ڈی سے بھی آ سکتے ہیں، کسی دوسرے ٹاسک سسٹم سے بھی آ سکتے ہیں) - یہ سب سے زیادہ ترجیح والا ٹاسک چنتا ہے - پرامپٹ جوڑتا ہے - ایجنٹ کو عمل کرنے کے لیے شروع کرتا ہے - فیصلہ کرتا ہے کہ آیا یہ ٹاسک مکمل ہوا ہے یا نہیں - اسٹیٹس لکھتا ہے - اگلا دور جاری رکھتا ہے اہم بات یہ ہے کہ: یہ سب آپ ٹرمینل میں دیکھ سکتے ہیں، اور کسی بھی وقت روک سکتے ہیں، کسی بھی وقت سنبھال سکتے ہیں۔ اس کی آفیشل پوزیشننگ بھی بہت واضح ہے: ایک انٹرایکٹو TUI والا ایجنٹ لوپ آرکیسٹریٹر، اور TUI / headless / remote کو سپورٹ کرتا ہے۔ ## میں کیوں کہتا ہوں کہ یہ "طویل عرصے تک چلانے" کے لیے زیادہ موزوں ہے؟ اسکرپٹ کو لوپ میں چلانے کا سب سے بڑا مسئلہ یہ نہیں ہے کہ یہ چل نہیں سکتا، بلکہ یہ ہے کہ آپ کو نہیں معلوم کہ یہ کہاں تک پہنچا ہے۔ آپ لاگز کو تیزی سے اپ ڈیٹ ہوتے دیکھتے ہیں، پنکھا بھی خوشی سے گھوم رہا ہوتا ہے، لیکن آپ کو یقین نہیں ہوتا: - کیا یہ ایک ہی بگ کو بار بار ٹھیک کر رہا ہے؟ - کیا یہ ایک ہی کوڈ کو بار بار تبدیل کر رہا ہے اور پھر اسے واپس تبدیل کر رہا ہے؟ - کیا یہ مکمل ہو چکا ہے، لیکن باہر نہیں نکلا؟ - کیا یہ کسی ٹیسٹ میں پھنس کر ڈیڈ لاک کا شکار ہو گیا ہے؟  رالف-ٹی یو آئی کا حل بہت "انجینئرنگ" والا ہے: - اس میں سیشن کا تصور ہے، اسٹیٹس ڈسک پر محفوظ ہو جائے گا (.ralph-tui/session.json) - کریش ہونے پر دوبارہ چلایا جا سکتا ہے (crash recovery) - اس میں لاک میکانزم ہے، تاکہ آپ کئی انسٹنسز کھول کر ڈائریکٹری کو گڑبڑ نہ کر دیں - یہ ہیڈ لیس ہو کر CI پر بھی چل سکتا ہے، اور یہاں تک کہ ریموٹ پر لسنر کھول کر، مقامی TUI کو اس سے جوڑا جا سکتا ہے۔ ایک جملے میں: **یہ زیادہ تر "آپ ایک کوڈ لکھنے والے ورکر کو کنٹرول کر رہے ہیں" کی طرح ہے، نہ کہ "آپ ایک اسکرپٹ کو بے قابو ہوتے دیکھ رہے ہیں"۔** ## انسٹال کیسے کریں رالف-ٹی یو آئی کا یہ سیٹ Bun/TypeScript ایکو سسٹم ہے، اس لیے اسے انسٹال کرنا کافی آسان ہے۔ آفیشل نے انسٹالیشن پیج بھی دیا ہے۔ پہلے تصدیق کریں کہ آپ کی مشین پر bun موجود ہے: `bun --version`پھر رالف-ٹی یو آئی انسٹال کریں (میں یہاں ایک عام انسٹالیشن طریقہ بتا رہا ہوں، تفصیلات کے لیے آفیشل انسٹالیشن پیج دیکھیں): `bun add -g ralph-tui`انسٹال کرنے کے بعد تصدیق کریں: `ralph-tui --help`اگر آپ Node کے صارف ہیں، اور bun کو استعمال نہیں کرنا چاہتے، تو یہ بھی ٹھیک ہے: `npm i -g ralph-tui` ## پہلے کوئی بڑا کام نہ کریں، ایک چھوٹا سا مکمل لوپ چلائیں میں تجویز کرتا ہوں کہ پہلی بار استعمال کرتے وقت، کوئی بڑا کام نہ کریں جیسے کہ "پوری ریپو کو دوبارہ تعمیر کرنا"۔ آپ صرف ایک کام کریں: **اسے ایک قابل قبول چھوٹے ٹاسک کو کامیابی سے مکمل کرنے دیں۔** ### انیشلائزیشن کوئی بھی ڈائریکٹری کھولیں: `mkdir ralph-tui-demo && cd ralph-tui-demo ralph-tui setup`یہ انٹرایکٹو وزرڈ کے عمل میں داخل ہو جائے گا، سیدھے الفاظ میں یہ ہے کہ "رالف-ٹی یو آئی کو آپ کے اس ریپوزٹری میں انسٹال کرنا"، یہ کرے گا: - خود بخود آپ کی مشین پر انسٹال کردہ ایجنٹس کا پتہ لگاتا ہے (جیسے Claude Code، OpenCode وغیرہ) - پروجیکٹ میں ایک کنفیگریشن فائل تیار کرتا ہے: .ralph-tui/config.toml - PRD جنریشن/ٹاسک کنورژن سے متعلقہ مہارتوں کو آسانی سے انسٹال کرتا ہے (بعد میں آپ کو خود سے دستی طور پر پریشان ہونے کی ضرورت نہیں ہے) میری ذاتی تجویز: پہلی بار سستی نہ کریں، **setup کو ایک بار ضرور چلائیں**۔ ### پروجیکٹ PRD تیار کریں setup چلانے کے بعد، اگلا مرحلہ سرکاری ٹیوٹوریل کا سب سے اہم حصہ ہے، اور یہ وہ حصہ ہے جو WeChat آفیشل اکاؤنٹ ڈیمو کے طور پر لکھنے کے لیے سب سے موزوں ہے: **create-prd**۔ `ralph-tui create-prd --chat` یہ کمانڈ ایک مکالماتی عمل میں داخل ہوگی، یہ ایک پروڈکٹ مینیجر کی طرح آپ سے مطالبہ کرے گی کہ آپ ضروریات کے اہداف، حدود اور قبولیت کے معیار بتائیں۔ پوچھنے کے بعد، یہ پروجیکٹ میں براہ راست دو چیزیں تیار کرے گا (یہ اہم ہے): - ایک PRD کی مارک ڈاؤن فائل: ./tasks/prd-feature.md - ایک قابل عمل ٹاسک فائل: ./prd.json اس مرحلے پر، آپ واقعی ralph-tui کے "معیاری بند لوپ" میں داخل ہوتے ہیں: **ضرورت (PRD) → ٹاسک (prd.json) → عمل (run)** ### چلائیں prd.json کے ساتھ، چلانا فطری ہے: `ralph-tui run --prd ./prd.json` آپ دیکھیں گے کہ TUI شروع ہو گیا ہے، اور لوپ شروع ہو جائے گا: ٹاسک کا انتخاب → عمل → مکمل ہونے کا فیصلہ → اسٹیٹس لکھنا → ختم یا اگلا راؤنڈ۔ پہلی بار چلانے پر، میں سختی سے تجویز کرتا ہوں کہ آپ ایک تکرار کی حد شامل کریں، پہلے اسے پنجرے میں بند کریں: `ralph-tui run --prd ./prd.json --iterations 5` چلانے کے بعد، آپ تبدیلیاں دیکھیں، ٹیسٹ چلائیں، اور دیکھیں کہ آیا PRD اور ٹاسک توقعات کے مطابق ہیں۔ اس بات کی تصدیق کریں کہ یہ لنک کھلا ہے، پھر تکرار کو جاری کریں، پھر ہیڈ لیس/ریموٹ پر جائیں، یہ ایک قابل اعتماد رفتار ہے۔ اس وقت، آپ بنیادی طور پر تصدیق کر سکتے ہیں: **یہ لوپ واقعی چل رہا ہے۔** ## ماڈل/ایجنٹ کا انتخاب کیسے کریں؟ پیسے بچانے کے بارے میں سچ بتانا ضروری ہے میں جانتا ہوں کہ بہت سے لوگ سب سے زیادہ اس بارے میں فکر مند ہیں: "کیا میں Claude Code استعمال کیے بغیر کر سکتا ہوں؟ کیا میں سستے ماڈل استعمال کر سکتا ہوں؟" جواب ہے: **ہاں۔** ralph-tui خود آپ کو ایجنٹ اور ماڈل کی وضاحت کرنے کی اجازت دیتا ہے (سرکاری رن دستاویزات میں مثالیں موجود ہیں)۔ مثال کے طور پر، Claude Opus استعمال کریں: `ralph-tui run --prd ./prd.json --agent claude --model opus` لیکن ایمانداری سے کہوں تو، میں خود "ٹیسٹ مکمل کرنے، لنٹ کو ٹھیک کرنے" جیسی چیزوں کے لیے Opus استعمال نہیں کروں گا، یہ بہت مہنگا ہے۔ میری عادت درجہ بندی کرنا ہے: - **سستے ماڈل**: بہت زیادہ بار بار چلنے والا کام چلائیں (ٹیسٹ مکمل کریں، تبصرے مکمل کریں، فارمیٹ ٹھیک کریں، حدود شامل کریں) - **مہنگے ماڈل**: صرف اہم نوڈس پر ظاہر ہوں (آرکیٹیکچر ایڈجسٹمنٹ، مشکل بگ، بنیادی منطق) اگر آپ ایک عام ڈویلپر ہیں، تو یہ سوچ اور بھی اہم ہے۔ کیونکہ آپ کے پاس بڑی فیکٹری کا بجٹ نہیں ہے، آپ کو لاگت کو کنٹرول کرنے کے قابل بنانا ہوگا تاکہ آپ اسے طویل عرصے تک چلا سکیں۔ ## کیا آپ مزید مزہ چاہتے ہیں؟ "PRD لکھنے" کو بھی ایجنٹ کے حوالے کر دیں ralph-tui میں ایک ڈیزائن ہے جو مجھے بہت پسند ہے: یہ skills کو سپورٹ کرتا ہے (سادہ الفاظ میں، یہ ایجنٹ کے لیے پلگ ان کمانڈز کا ایک سیٹ ہے)۔ سرکاری انسٹالیشن کا طریقہ add-skill استعمال کرنا ہے: `bunx add-skill subsy/ralph-tui --all` یا اسے ایک مخصوص ایجنٹ پر انسٹال کریں، جیسے claude-code: `bunx add-skill subsy/ralph-tui -a claude-code -g -y` انسٹال کرنے کے بعد، آپ ایجنٹ سیشن میں سلیش کمانڈ استعمال کر سکتے ہیں: `/ralph-tui-prd /ralph-tui-create-json /ralph-tui-create-beads` یہ بالکل ایسا ہی ہے جیسے آپ نے IDE میں پلگ ان انسٹال کیا ہے، سوائے اس کے کہ یہ پلگ ان ایجنٹ کے لیے ہے۔ اس کا مطلب یہ ہے کہ "دستی طور پر ضروریات کو منتقل کرنے" کے وقت کو کم کیا جائے، تاکہ ضروریات → ٹاسک → عمل ایک اسمبلی لائن کی طرح ہو۔ ## اسے کب استعمال کرنا چاہیے؟ اسے کب استعمال نہیں کرنا چاہیے؟میں اس قسم کی کہانی کو پسند نہیں کرتا جو کہتی ہے کہ "ہر چیز کو AI سے کیا جا سکتا ہے"، یہ گمراہ کن ہو سکتی ہے۔ ٹولز صرف ٹولز ہیں، اور وہ صرف اس صورت میں قیمتی ہیں جب وہ کسی خاص منظر نامے کے لیے موزوں ہوں۔ ### ralph-tui استعمال کرنے کے لیے موزوں منظرنامے آپ کے پاس اس قسم کا کام ہے: - ٹیسٹ کو مکمل کرنا (خاص طور پر پرانے پروجیکٹس کے لیے) - lint / format کو درست کرنا - چھوٹے قدموں میں ری فیکٹرنگ (بار بار کوڈ کو جمع کرنا) - بیچوں میں اقسام شامل کرنا، حدود کو مکمل کرنا - ضروریات کو توڑنے کے بعد ٹاسک کیو کے ذریعے آہستہ آہستہ آگے بڑھنا اس قسم کے کام میں ایک مشترکہ نقطہ ہے: **بہت سے کام، اعلی تکرار، قابل قبول، اور تکراری طور پر آگے بڑھایا جا سکتا ہے۔** ### ralph-tui کو زبردستی استعمال کرنے کے لیے ناموزوں منظرنامے آپ یہ کر رہے ہیں: - ایک وقتی بڑی ری فیکٹرنگ، قبولیت کے واضح معیارات کے بغیر - ضرورت خود مبہم ہے، آپ کے دماغ میں پوشیدہ علم پر انحصار کرتے ہوئے - بہت زیادہ کراس ٹیم مواصلات / تصدیق کی ضرورت ہے - آپ کو مصنوعات کا فیصلہ کرنے کی ضرورت ہے اس قسم کا کام، ایجنٹ لوپ صرف افراتفری کو بڑھا دے گا۔ ## ralph-loop (ralph-claude-code) سے اس کا کیا فرق ہے؟ **ralph-claude-code** ایک "Claude Code کے خودکار ڈرائیونگ پلگ ان" کی طرح ہے: اسکرپٹ اسے کھینچتا ہے، لوپ چلاتا ہے، باہر نکلنے کا پتہ لگاتا ہے، ریٹ لمیٹنگ، اور سرکٹ بریکر سب آپ کے لیے ہیں۔ آپ کو "تیزی" کی ضرورت ہے، اور یہ بہت تیز ہے۔ **ralph-tui** ایک "ایجنٹ لوپ کے انجینئرنگ کنسول" کی طرح ہے: یہ کسی خاص ماڈل کو ویلڈ نہیں کرتا ہے، اور نہ ہی یہ کسی خاص ٹاسک سسٹم کو ویلڈ کرتا ہے۔ یہ "طویل مدتی چلانے، قابل مشاہدہ، قابل کنٹرول، قابل بحالی، اور دور سے" جیسے انجینئرنگ مسائل کو حل کرنا چاہتا ہے۔ تو آپ مجھ سے پوچھتے ہیں کہ کیسے منتخب کریں؟ - آپ Claude Code صارف ہیں، اور آپ اسے جلدی سے چلانا چاہتے ہیں → ralph-claude-code - آپ مختلف ماڈلز کو جوڑنا چاہتے ہیں، پیسے بچانا چاہتے ہیں، اور لوپ کو بطور سروس منظم کرنا چاہتے ہیں → ralph-tui ## آخر میں: اسے اپنی ریپوزٹری کو لیبارٹری نہ بننے دیں۔ میرے پاس ایجنٹ لوپ چلانے کے لیے کچھ سخت اصول ہیں، میں انہیں یہاں لکھ رہا ہوں، آپ ان پر عمل کریں، اور آپ کے ناکام ہونے کے امکانات بہت کم ہوں گے: - **برانچ میں چلائیں، مین پر جان نہ دیں۔** - **پہلی بار چلانے پر ہمیشہ --iterations شامل کریں، پہلے چھوٹے قدموں میں تصدیق کریں کہ یہ پاگل نہیں ہوگا۔** - **ٹاسک قابل قبول ہونا چاہیے**: یا تو یہ ٹیسٹ چلا سکتا ہے، یا یہ lint چلا سکتا ہے، یا یہ آؤٹ پٹ فائلوں کا موازنہ کر سکتا ہے۔ - **آپ کو رکنا سیکھنا ہوگا**: یہ دیکھ کر کہ یہ دائروں میں گھومنا شروع کر رہا ہے، جاری رکھنے سے زیادہ پیسے بچانا زیادہ سمجھداری ہے۔ - **سستے ماڈلز سے سخت کام کروائیں، مہنگے ماڈلز سے اہم کام کروائیں**: لاگت آپریشن سے آتی ہے، دعا سے نہیں۔پراجیکٹ ایڈریس: https://github.com/subsy/ralph-tui