Waxaad sugayseen ayaa ugu dambeyntii timid! Ralph TUI, Ralph Loop oo la arki karo

Waxaan horey u qoray cashar ku saabsan ralph-loop, saaxiibo badan ayaa ka dib markii ay dhamaystireen orodka ay soo celiyeen jawaab celin isku mid ah: Waa wax fiican, Claude Code ayaa ugu dambeyntii socon kara muddo dheer. Laakiin mararka qaarkood markaad aragto inaysan u muuqan inay dhaqaaqayso, waxaad si lama huraan ah u dareemeysaa walaac: "Ma horumar ayey sameyneysaa, mise way istaagtay?"

Tani waa sababta aan dhawaan ula tacaalay ralph-tui.

ralph-tui kuma qasbeyso in lagu xiro Claude Code, waxay dhaxashaa oo ay horumarisaa nuxurka ralph loop, waxayna muuqaal ka dhigtaa fulinta hawsha iyo habka, taasoo si weyn u yareynaysa caqabadda u oggolaanaysa moodellada waaweyn inay shaqeeyaan muddo dheer. Waxaad si buuxda u qaadan kartaa wakiil kale, moodel kale, mid gudaha laga sameeyay, mid jaban, mid aad awood u leedahay inaad muddo dheer socodsiiso. Iyadoo la kaashanayo ralph-tui, annaga dadka caadiga ah, macnaheedu ma yara in laga beddelo gacanta una beddelo mid toos ah oo leh xakamaynta xawaaraha.

Waa maxay dhab ahaan?

Waxaad u malayn kartaa ralph-tui inay tahay "AI coding agent loop orchestrator", kaliya kuma qanacsana "inay socon karto", waxay aad ugu taxaddaraysaa "inaad arki karto, xakamayn karto, soo celin karto".

Habka aasaasiga ah ee ay u shaqeyso waa mid fudud:

• Waxaad siisaa hawlo badan (waxay ka imaan karaan PRD, ama nidaamyo kale oo hawleed)
• Waxay doorataa midda ugu mudnaanta badan
• Waxay isku daraysaa prompt
• Waxay kicineysaa wakiil si uu u fuliyo
• Waxay xukuntaa haddii hawshan loo tixgelin karo in la dhammeeyay
• Waxay qortaa xaaladda
• Wareegga xiga ayaa sii socda

Muhiimadu waxay tahay: waxaad wax walba ku arki kartaa terminalka, waxaadna joojin kartaa oo aad la wareegi kartaa wakhti kasta. Si rasmi ah ayey u qortay booskeeda si toos ah: agent loop orchestrator oo leh TUI isdhexgal ah, oo taageerta TUI / headless / remote.

Maxaan u leeyahay waxay ku habboon tahay "orodka muddada dheer"?

Dhibaatada ugu weyn ee qoraalka orodka loop maaha inuusan socon karin, laakiin ma ogid halka uu marayo.

Waxaad aragtaa diiwaannada oo si degdeg ah u socda, marawaxaduna waxay u rogmaysaa si farxad leh, laakiin ma hubtid:

• Miyay si isdaba joog ah u hagaajinaysaa isla bugga?
• Miyay si joogto ah u beddelaysaa isla qaybta koodhka ka dibna dib u beddelaysaa?
• Miyay dhamaysay, kaliya ma aysan bixin?
• Miyay ku xayiran tahay imtixaan gaar ah oo ku jira loop dhimasho?

Xalka ralph-tui waa mid aad u "injineernimo":

• Waxaa jira fikrad session ah, xaaladduna way dhici doontaa (.ralph-tui/session.json)
• Haddii ay burburto, way soo kaban kartaa (crash recovery)
• Waxaa jira hab quful, si looga fogaado inaad furto dhowr tusaale oo aad ka dhigto tusaha tofu
• Waxay sidoo kale ku tuuri kartaa headless CI si ay u socoto, xitaa remote waxay ka furi kartaa dhegeyste dhamaadka fog, TUI-ga maxalliga ah ayaa ku xirmi doona

Hal jumlad: Waxay u badan tahay "inaad maamusho shaqaale qori kara koodh", halkii aad "ka fiirsan lahayd qoraal waalan".

Sida loo rakibo

Ralph-tui set-up waa Bun/TypeScript ecosystem, rakibiddu waa mid fudud. Mas'uuliyiintu waxay sidoo kale bixiyeen bog rakibaad.

Ugu horreyntii xaqiiji inaad ku haysato bun mashiinkaaga:

bun --versionka dibna rakib ralph-tui (waxaan halkan ku siinayaa hab rakibaad oo caadi ah, si gaar ah u tixraac bogga rakibaadda rasmiga ah):

bun add -g ralph-tuiKa dib markaad rakibto, xaqiiji:

ralph-tui --helpHaddii aad tahay Node party, oo aadan rabin inaad taabato bun, sidoo kale waa hagaag:

npm i -g ralph-tui

Ha samayn wax weyn marka hore, orod loop xiran oo yar

Waxaan kugula talinayaa markaad isticmaasho markii ugu horeysay, ha ku degdegin inaad samayso waxa "dib u habaynta kaydka oo dhan". Kaliya samee hal shay: ka dhig mid socda hawl yar oo la aqbali karo.

Bilow

Fur tusaha si aan kala sooc lahayn:

mkdir ralph-tui-demo && cd ralph-tui-demo ralph-tui setupTani waxay geli doontaa habraaca hagida isdhexgalka, si cad u hadal, waa "rakib ralph-tui kaydkaaga", way:

• Si toos ah u ogaada wixii agents ah ee ku rakiban mashiinkaaga (sida Claude Code, OpenCode, iwm.)
• Ka abuur qaabeynta mashruuca gudihiisa: .ralph-tui/config.toml
• Si fudud u rakib xirfadaha la xiriira abuurista PRD/beddelka hawsha (ka dib uma baahnid inaad gacanta ku hagaajiso)

Talo ahaan, markii ugu horreysay ha caajisin, hubi inaad socodsiiso setup hal mar.

Abuurista PRD Mashruuc

Ka dib marka setup la socodsiiyo, tallaabada xigta waa tan ugu muhiimsan ee casharrada rasmiga ah, sidoo kalena ku habboon in loo qoro demo ahaan: create-prd.

ralph-tui create-prd --chat amarkani wuxuu geli doonaa hab wada hadal, wuxuuna ku weydiin doonaa ujeeddada baahidaada, xuduudaha, iyo heerarka aqbalaadda sida maareeyaha wax soo saarka oo kale. Ka dib markuu weydiiyo, wuxuu si toos ah u soo saari doonaa laba shay mashruuca gudihiisa (tani waa qodobka ugu muhiimsan):

• Faylka markdown ee PRD: ./tasks/prd-feature.md
• Faylka hawsha ee si toos ah loo fulin karo: ./prd.json

Tallaabadan, waxaad si dhab ah u gashay "wareegga xiran ee caadiga ah" ee ralph-tui:

Baahida (PRD) → Hawsha (prd.json) → Fulinta (run)

Socodsii

Markaad haysato prd.json, socodsiinta ayaa noqota mid macquul ah:

ralph-tui run --prd ./prd.json waxaad arki doontaa TUI oo soo baxaya, oo bilaabaya wareegga: dooro hawsha → fuli → go'aami in la dhammeeyay → qor xaaladda → dhammaato ama wareegga xiga.

Markii ugu horreysay ee aad socodsiiso, waxaan si xooggan u soo jeedinayaa inaad ku darto xadka isdhexgalka, marka hore ku xir qafis:

ralph-tui run --prd ./prd.json --iterations 5 ka dib markaad socodsiiso, waxaad eegi doontaa isbeddellada, socodsiisaa imtixaannada, oo aad eegi doontaa haddii PRD iyo hawsha ay waafaqsan yihiin waxa laga filayo. Hubi in isku xirkani uu shaqeynayo, ka dibna sii daa isdhexgalka, ka dibna u gudub headless/remote, tani waa habka la isku halleyn karo.

Markaan, waxaad asal ahaan xaqiijin kartaa: wareeggan ayaa dhab ahaantii socda.

Sidee loo Doortaa Moodelka/Agent-ka? Runta waa in laga hadlaa arrinta lacagta

Waxaan ogahay in dad badan ay ugu walaacsan yihiin: "Ma isticmaali karaa Claude Code? Ma isticmaali karaa moodel jaban?"

Jawaabtu waa: Haa.

ralph-tui lafteedu waxay ku taageertaa inaad cayimto agent-ka iyo moodelka (waxaa jira tusaalooyin dukumeentiga rasmiga ah ee run).

Tusaale ahaan, isticmaal Claude Opus:

ralph-tui run --prd ./prd.json --agent claude --model opus laakiin si daacad ah, anigu kuma isticmaali doono Opus si aan u qabto shaqooyinka sida "buuxinta imtixaannada, hagaajinta lint", aad ayey u qaalisan tahay. Caadadaydu waa inaan kala saaro:

• Moodel jaban: socodsii shaqooyin badan oo soo noqnoqda (buuxi imtixaannada, buuxi faallooyinka, hagaaji qaabka, ku dar xuduudaha)
• Moodel qaali ah: kaliya ka soo muuqda qodobada muhiimka ah (hagaajinta qaab dhismeedka, cayayaanka adag, macquulka asaasiga ah)

Haddii aad tahay horumariye caadi ah, habkani wuu ka sii muhiimsan yahay. Sababtoo ah ma tihid miisaaniyad shirkad weyn, waxaad u baahan tahay inaad ka dhigto kharashka mid la xakameyn karo si aad u socodsiiso muddo dheer.

Ma rabtaa inaad ka sii raaxaysato? Sidoo kale u dhiib "qorista PRD" agent-ka

ralph-tui waxay leedahay naqshad aan jeclahay: waxay taageertaa xirfadaha (si cad, waa amarro dheeri ah oo loogu talagalay agent-ka).

Habka rasmiga ah ee lagu rakibo waa iyadoo la isticmaalayo add-skill:

bunx add-skill subsy/ralph-tui --all ama ku rakib agent gaar ah, sida claude-code:

bunx add-skill subsy/ralph-tui -a claude-code -g -y ka dib markaad rakibto, waxaad isticmaali kartaa amarka slash ee wadahadalka agent-ka:

/ralph-tui-prd /ralph-tui-create-json /ralph-tui-create-beads tani waxay la mid tahay inaad ku rakibtay plugin IDE, laakiin plugin-kani waxaa loogu talagalay agent-ka. Muhiimaddiisu waa in la yareeyo waqtiga "gacanta lagu raro baahiyaha", si baahida → hawsha → fulinta ay u noqdaan kuwo u eg xariiq wax soo saar.

Goorma ayay tahay in la isticmaalo? Goorma yaan la isticmaalin?Anigu ma jecli sheekada ah "wax walba waxaa lagu xallin karaa AI", way fududahay in dadka la marin habaabiyo. Qalabku waa qalab, waxaana uu qiimo leeyahay marka uu ku habboon yahay goobta.

Goobaha Ku Habboon Isticmaalka ralph-tui

Waxaad haysataa shaqooyin noocaan ah:

• Buuxinta tijaabooyinka (gaar ahaan mashaariicda hore)
• Hagaajinta lint / format
• Dib-u-habeyn yar-yar (ururinta koodhka soo noqnoqda)
• Ku darista noocyada, buuxinta xuduudaha
• Burburinta baahida ka dibna si tartiib ah u riix safka shaqada

Shaqooyinkan waxay leeyihiin hal shay oo ay wadaagaan: Shaqooyin badan, soo noqnoqosho sare, waa la aqbali karaa, waana la horumarin karaa.

Goobaha Aan Ku Habboonayn Isticmaalka Ralph-TUI

Waxaad samaynaysaa waxyaabahaan:

• Dib-u-habeyn weyn oo hal mar ah, heerarka aqbalaadda aan caddayn
• Baahida lafteedu waa mid aan caddayn, oo ku tiirsan aqoontaada qarsoon
• Waxay u baahan tahay isgaarsiin/xaqiijin badan oo kooxaha dhexdooda ah
• Waxay u baahan tahay inaad samayso go'aanno wax soo saar

Shaqooyinka noocaan ah, wareegga wakiilku wuxuu kaliya weynayn doonaa jahwareerka.

Maxaa u dhexeeya ralph-loop (ralph-claude-code)?

ralph-claude-code waxay u eg tahay "Claude Code oo lagu daray darawal toos ah": qoraalku wuu kiciyaa, wuxuu socodsiiyaa wareegga, wuxuuna daboolayaa ogaanshaha bixitaanka, xaddidaadda socodka, iyo jebiyaha wareegga. Waxaad rabtaa "dhaqso", wayna dhaqso badan tahay.

ralph-tui waxay u eg tahay "console-ka injineernimada ee wareegga wakiilka": kuma dhejiso moodeel gaar ah, kuma dhejiso nidaam shaqo gaar ah. Waxay doonaysaa inay xalliso dhibaatooyinka injineernimada sida "socodsiinta muddada dheer, la arki karo, la xakamayn karo, la soo celin karo, iyo fog".

Markaa haddii aad i waydiiso sida loo doorto?

• Waxaad tahay isticmaale Claude Code, waxaadna rabtaa inaad si degdeg ah u socodsiiso → ralph-claude-code
• Waxaad rabtaa inaad ku xidho moodello kala duwan, waxaad rabtaa inaad lacag kaydsato, waxaadna rabtaa inaad wareegga u maamusho sidii adeeg → ralph-tui

Ugu dambeyntii: Ha u oggolaan inay bakhaarkaaga u isticmaasho shaybaar

Waxaan leeyahay dhowr xeer oo adag oo aan ku socodsiiyo wareegga wakiilka, waxaan ku qorayaa halkan si aad u raacdo, fursadaha guuldaradu way yaraan doonaan:

• Ku socodsii laan, ha ku ciyaarin main.
• Marka ugu horeysa ee aad socodsiiso, hubi inaad ku darto --iterations, marka hore xaqiiji inaysan waalanayn.
• Shaqadu waa inay noqotaa mid la aqbali karo: ama way socodsiin kartaa tijaabooyinka, ama way socodsiin kartaa lint, ama way barbar dhigi kartaa faylasha wax soo saarka.
• Waa inaad barato inaad istaagto: marka aad aragto inay bilaabayso inay wareegto, joojinta ayaa ka caqli badan inaad sii waddo gubashada lacagta.
• Moodellada jaban waxay qabtaan shaqo qallafsan, moodellada qaaliga ah waxay qabtaan shaqo muhiim ah: qiimaha waxaa lagu shaqeeyaa, lagamana baryo.Cinwaanka Mashruuca: https://github.com/subsy/ralph-tui