অবশেষে তোমাদের জন্য এটা এসেছে! Ralph TUI, Ralph Loop-এর ভিজ্যুয়ালাইজেশন

আমি আগে ralph-loop নিয়ে একটি টিউটোরিয়াল লিখেছিলাম, অনেক বন্ধু সেটা অনুসরণ করে চালানোর পরে একই রকম প্রতিক্রিয়া জানিয়েছে: দারুণ, Claude Code অবশেষে দীর্ঘক্ষণ ধরে চলতে পারছে। কিন্তু মাঝে মাঝে যখন তোমরা দেখবে এটা স্থির হয়ে আছে, তখন মনে সন্দেহ জাগতে পারে: "এটা কি আসলেই চলছে, নাকি একই জায়গায় ঘুরপাক খাচ্ছে?"

এটাই হল সম্প্রতি ralph-tui নিয়ে আমার কাজ করার কারণ।

ralph-tui Claude Code-এর সাথে বাধ্যতামূলকভাবে যুক্ত নয়, এটি ralph loop-এর মূল বৈশিষ্ট্যগুলিকে উত্তরাধিকার সূত্রে পেয়েছে এবং সেগুলোকে উন্নত করেছে, এবং টাস্ক এক্সিকিউশন এবং প্রক্রিয়াটিকে ভিজ্যুয়ালাইজ করে, যা বড় মডেলগুলিকে দীর্ঘ সময় ধরে কাজ করানোর পথে অনেক বড় বাধা কমিয়ে দেয়। তোমরা অন্য agent, অন্য মডেল, দেশীয়, সস্তা, যা তোমরা দীর্ঘ সময় ধরে চালাতে পারবে, সেগুলোকে ব্যবহার করতে পারো। ralph-tui থাকার কারণে, আমাদের সাধারণ মানুষের জন্য, এটা ম্যানুয়াল গিয়ার থেকে অটোমেটিক গিয়ার এবং ক্রুজ কন্ট্রোল যুক্ত গাড়ির মতো।

এটা আসলে কী?

তোমরা ralph-tui-কে একটি "AI coding agent-এর লুপ অর্কেস্ট্রেটর" হিসেবে ভাবতে পারো, তবে এটা শুধু "চলতে পারা" নিয়ে সন্তুষ্ট নয়, এটা "তোমরা দেখতে পাবে, নিয়ন্ত্রণ করতে পারবে, পুনরুদ্ধার করতে পারবে" সে বিষয়ে বেশি আগ্রহী।

এটার মৌলিক কাজের পদ্ধতি খুবই সাধারণ:

• তোমরা এটাকে অনেকগুলো টাস্ক দেবে (PRD থেকেও আসতে পারে, অন্য কোনো টাস্ক সিস্টেম থেকেও আসতে পারে)
• এটা সবচেয়ে বেশি অগ্রাধিকারের টাস্কটি বেছে নেবে
• prompt তৈরি করবে
• agent-কে ডেকে এনে এক্সিকিউট করাবে
• বিচার করবে যে টাস্কটি সম্পন্ন হয়েছে কিনা
• স্ট্যাটাস লিখবে
• পরবর্তী রাউন্ডে আবার শুরু করবে

গুরুত্বপূর্ণ বিষয় হল: এই সবকিছু তোমরা টার্মিনালে দেখতে পাবে, এবং যেকোনো সময় থামাতে পারবে, যেকোনো সময় পুনরায় শুরু করতে পারবে। এর অফিসিয়াল অবস্থানও খুব স্পষ্টভাবে লেখা আছে: একটি ইন্টারেক্টিভ TUI সহ agent loop orchestrator, এবং এটি TUI / headless / remote সাপোর্ট করে।

কেন আমি বলছি এটা "দীর্ঘ সময় ধরে চালানোর" জন্য বেশি উপযুক্ত?

স্ক্রিপ্ট লুপ চালানোর সবচেয়ে বড় সমস্যা হল, এটা চলতে না পারা নয়, বরং এটা কোথায় চলছে সেটা জানতে না পারা।

তোমরা দেখবে লগ দ্রুত স্ক্রল করছে, ফ্যানও বেশ ভালোভাবে ঘুরছে, কিন্তু তোমাদের মনে সন্দেহ থাকবে:

• এটা কি একই বাগ বারবার ঠিক করছে?
• এটা কি একই কোড বারবার পরিবর্তন করছে এবং আবার আগের অবস্থায় ফিরিয়ে আনছে?
• এটা কি ইতিমধ্যেই সম্পন্ন হয়েছে, শুধু বের হয়নি?
• এটা কি কোনো টেস্টে আটকে গিয়ে লুপে ঘুরছে?

ralph-tui-এর সমাধান খুবই "প্রকৌশলী" ধরনের:

• session-এর ধারণা আছে, স্ট্যাটাস ডিস্কে সেভ হবে (.ralph-tui/session.json)
• ক্র্যাশ করলে রিকভারি করে আবার চালানো যাবে (crash recovery)
• লক মেকানিজম আছে, যাতে তোমরা একাধিক ইনস্ট্যান্স খুলে ডিরেক্টরিকে জগাখিচুড়ি বানিয়ে না ফেলো
• এমনকি headless মোডে CI-তে চালানো যাবে, অথবা রিমোটলি লিসেনার চালু করে লোকাল TUI দিয়ে কানেক্ট করা যাবে

এক কথায়: এটা অনেকটা "তোমরা একজন কোড লিখতে পারা কর্মীকে নিয়ন্ত্রণ করছো"-এর মতো, "তোমরা একটি স্ক্রিপ্টের খেয়াল রাখছো যেটা এলোমেলোভাবে চলছে"-এর মতো নয়।

কিভাবে ইন্সটল করবে

ralph-tui-এর এই সেটআপ Bun/TypeScript ইকোসিস্টেমে তৈরি, তাই ইন্সটল করা বেশ সহজ। অফিসিয়াল ইনস্টলেশন পেজও দেওয়া আছে।

প্রথমে নিশ্চিত করো তোমাদের মেশিনে bun আছে:

bun --version এরপর ralph-tui ইন্সটল করো (আমি এখানে একটি সাধারণ ইন্সটলেশন পদ্ধতি দিচ্ছি, বিস্তারিত জানার জন্য অফিসিয়াল ইনস্টলেশন পেজ দেখুন):

bun add -g ralph-tui ইন্সটল করার পরে নিশ্চিত করুন:

ralph-tui --help তোমরা যদি Node ব্যবহারকারী হও, এবং bun ব্যবহার করতে না চাও, তাও হবে:

npm i -g ralph-tui

প্রথমে বড় কিছু করার দরকার নেই, ছোট করে একটা লুপ চালান

আমি পরামর্শ দেব প্রথমবার ব্যবহারের সময়, সরাসরি "পুরো repo রিফ্যাক্টর" করার মতো কিছু করতে যেও না। তোমরা শুধু একটা কাজ করো: এটাকে একটি গ্রহণযোগ্য ছোট টাস্কের মাধ্যমে চালান।

ইনিশিয়ালাইজেশন

যেকোনো একটি ডিরেক্টরি খুলুন:

mkdir ralph-tui-demo && cd ralph-tui-demo ralph-tui setup এটা ইন্টারেক্টিভ গাইডের দিকে নিয়ে যাবে, সোজা কথায় এটা হল "ralph-tui-কে তোমাদের এই রিপোজিটরিতে ইন্সটল করা", এটা যা করবে:

• স্বয়ংক্রিয়ভাবে আপনার মেশিনে ইনস্টল করা এজেন্টগুলি সনাক্ত করে (যেমন ক্লড কোড, ওপেনকোড ইত্যাদি)
• প্রোজেক্টে একটি কনফিগারেশন ফাইল তৈরি করে: .ralph-tui/config.toml
• PRD তৈরি/টাস্ক রূপান্তর সম্পর্কিত স্কিলগুলি ইনস্টল করে (পরে আপনাকে নিজে থেকে এটি করতে হবে না)

আমার ব্যক্তিগত পরামর্শ: প্রথমবার অলসতা করবেন না, সেটআপ অবশ্যই একবার চালাতে হবে।

প্রোজেক্ট PRD তৈরি করা

সেটআপ চালানোর পরে, পরবর্তী ধাপটি হল অফিসিয়াল টিউটোরিয়ালের সবচেয়ে গুরুত্বপূর্ণ অংশ, যা একটি পাবলিক অ্যাকাউন্ট ডেমো হিসাবে লেখার জন্য সবচেয়ে উপযুক্ত: create-prd।

ralph-tui create-prd --chat এই কমান্ডটি একটি কথোপকথনমূলক প্রক্রিয়ার মধ্যে প্রবেশ করবে, এটি একজন প্রোডাক্ট ম্যানেজারের মতো আপনার কাছ থেকে চাহিদার লক্ষ্য, সীমানা শর্ত এবং গ্রহণযোগ্যতার মান সম্পর্কে জিজ্ঞাসা করবে। জিজ্ঞাসা করার পরে, এটি প্রোজেক্টে সরাসরি দুটি জিনিস আউটপুট করবে (এটিই মূল বিষয়):

• একটি PRD এর markdown ফাইল: ./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 এবং টাস্ক প্রত্যাশা পূরণ করে কিনা তা দেখুন। নিশ্চিত করুন যে এই লিঙ্কটি কাজ করছে, তারপর পুনরাবৃত্তিগুলি ছেড়ে দিন, তারপর হেডলেস/রিমোট চালু করুন, এটিই নির্ভরযোগ্য ছন্দ।

এই সময়ে আপনি মূলত নিশ্চিত করতে পারবেন: এই লুপটি সত্যিই চলছে।

মডেল/এজেন্ট কীভাবে নির্বাচন করবেন? অর্থ সাশ্রয়ের বিষয়ে সত্যি কথা বলা উচিত

আমি জানি অনেকে সবচেয়ে বেশি আগ্রহী: "আমি কি ক্লড কোড ব্যবহার না করে থাকতে পারি? আমি কি সস্তা মডেল ব্যবহার করতে পারি?"

উত্তর হল: হ্যাঁ।

ralph-tui আপনাকে এজেন্ট এবং মডেল নির্দিষ্ট করার জন্য সমর্থন করে (অফিসিয়াল রান ডকুমেন্টে উদাহরণ রয়েছে)।

যেমন ক্লড ওপাস ব্যবহার করা:

ralph-tui run --prd ./prd.json --agent claude --model opus তবে সত্যি কথা বলতে, আমি নিজে "টেস্ট যোগ করা, লিন্ট ঠিক করা" এর মতো কাজের জন্য ওপাস ব্যবহার করব না, এটি খুব ব্যয়বহুল। আমার অভ্যাস হল স্তরবিন্যাস করা:

• সস্তা মডেল: প্রচুর পুনরাবৃত্তিমূলক কাজ চালানো (টেস্ট যোগ করা, মন্তব্য যোগ করা, বিন্যাস ঠিক করা, সীমানা যোগ করা)
• দামী মডেল: শুধুমাত্র গুরুত্বপূর্ণ নোডে উপস্থিত হওয়া (আর্কিটেকচার সমন্বয়, কঠিন বাগ, মূল যুক্তি)

আপনি যদি সাধারণ ডেভেলপার হন তবে এই ধারণাটি আরও গুরুত্বপূর্ণ। কারণ আপনি বড় কোম্পানির বাজেট নন, আপনাকে খরচ নিয়ন্ত্রণ করতে হবে, যাতে আপনি দীর্ঘ সময় ধরে চালাতে পারেন।

আরও ভালো কিছু চান? "PRD লেখা" এজেন্টকে দিন

ralph-tui এর একটি ডিজাইন আমার বেশ পছন্দ: এটি স্কিল সমর্থন করে (সহজ ভাষায়, এটি একটি এজেন্টের বহিরাগত কমান্ড)।

অফিসিয়াল ইনস্টলেশন পদ্ধতি হল 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 ব্যবহারের অনুপযুক্ত পরিস্থিতি

যদি আপনি এই ধরণের কাজ করতে চান:

• একবারে বড় রিফ্যাক্টরিং, যেখানে যাচাইয়ের মানদণ্ড অস্পষ্ট
• রিকোয়ারমেন্ট নিজেই অস্পষ্ট, আপনার ভেতরের জ্ঞানের উপর নির্ভরশীল
• প্রচুর ক্রস-টিম যোগাযোগ/ নিশ্চিতকরণের প্রয়োজন
• আপনার প্রোডাক্ট নিয়ে বিচার-বিবেচনা করার প্রয়োজন

এই ধরণের টাস্কে, agent loop শুধু বিশৃঙ্খলা বাড়াবে।

ralph-loop (ralph-claude-code) এর থেকে এটা কিভাবে আলাদা?

ralph-claude-code অনেকটা "Claude Code এর অটোমেটিক ড্রাইভিং এক্সটেনশন" এর মতো: স্ক্রিপ্ট এটাকে চালু করে, লুপ চালায়, এক্সিট ডিটেকশন, থ্রটলিং, এবং সার্কিট ব্রেকার সবকিছু আপনার জন্য ব্যাকআপ হিসেবে থাকে। আপনার যদি "দ্রুত" কিছু করার প্রয়োজন হয়, তবে এটি খুব দ্রুত কাজ করে।

ralph-tui অনেকটা "agent loop এর ইঞ্জিনিয়ারিং কন্ট্রোল প্যানেল" এর মতো: এটা কোনো নির্দিষ্ট মডেল বা টাস্ক সিস্টেমের সাথে বাঁধা নয়। এটা "দীর্ঘ সময় ধরে চালানো, পর্যবেক্ষণযোগ্য, নিয়ন্ত্রণযোগ্য, পুনরুদ্ধারযোগ্য, এবং দূরবর্তীভাবে ব্যবহারযোগ্য" এই ধরণের ইঞ্জিনিয়ারিং সমস্যাগুলো সমাধান করতে চায়।

সুতরাং আপনি যদি আমাকে জিজ্ঞাসা করেন কোনটি বেছে নিতে হবে?

• আপনি যদি Claude Code ব্যবহারকারী হন এবং দ্রুত এটি চালাতে চান → ralph-claude-code
• আপনি যদি বিভিন্ন মডেল ব্যবহার করতে চান, খরচ কমাতে চান, এবং লুপকে একটি পরিষেবা হিসেবে পরিচালনা করতে চান → ralph-tui

শেষ কথা: এটাকে আপনার রিপোজিটরিকে ল্যাবরেটরি বানাতে দেবেন না

আমার নিজের agent loop চালানোর কিছু নিয়ম আছে, এখানে লিখে দিলাম, এগুলো অনুসরণ করলে ব্যর্থ হওয়ার সম্ভাবনা অনেক কম:

• ব্রাঞ্চ ব্যবহার করে চালান, মেইন ব্রাঞ্চে চালাবেন না।
• প্রথমবার চালানোর সময় অবশ্যই --iterations যোগ করুন, প্রথমে ছোট ধাপে নিশ্চিত করুন যে এটি পাগল হয়ে যাচ্ছে না।
• টাস্ক অবশ্যই যাচাইযোগ্য হতে হবে: হয় টেস্ট চালাতে হবে, অথবা লিন্ট চালাতে হবে, অথবা আউটপুট ফাইলের তুলনা করতে হবে।
• আপনাকে থামতে জানতে হবে: যখন দেখবেন এটি একই কাজ বারবার করছে, তখন চালিয়ে যাওয়ার চেয়ে থামানো বুদ্ধিমানের কাজ।
• কম দামের মডেল দিয়ে সাধারণ কাজ করান, বেশি দামের মডেল দিয়ে গুরুত্বপূর্ণ কাজ করান: খরচ পরিচালনা করে কমাতে হয়, প্রার্থনা করে নয়।প্রকল্পের ঠিকানাঃ https://github.com/subsy/ralph-tui