Pagaliau tai čia! Ralph TUI, vizualizuotas Ralph Loop

Anksčiau rašiau pamoką apie ralph-loop, ir daugelis draugų, kurie ją išbandė, pateikė panašų atsiliepimą: Smagu, Claude Code pagaliau gali veikti ilgą laiką. Tačiau kartais, kai stebite, atrodo, kad jis nejuda, ir neišvengiamai kyla abejonių: "Ar jis progresuoja, ar sukasi vietoje?"

Štai kodėl pastaruoju metu užsiėmiau su ralph-tui.

ralph-tui nepriverstinai susietas su Claude Code, jis paveldi ir plėtoja ralph loop esmę, vizualizuoja užduočių vykdymą ir procesą, labai sumažindamas kliūtis dideliems modeliams dirbti ilgą laiką. Jūs visiškai galite prijungti kitus agentus, kitus modelius, vietinius, pigius, tokius, kuriuos galite sau leisti paleisti ilgą laiką. Su ralph-tui, mums, paprastiems žmonėms, tai prilygsta perėjimui nuo mechaninės pavarų dėžės prie automatinės su pastovaus greičio palaikymu.

Kas tai iš tikrųjų yra?

ralph-tui galite suprasti kaip "AI kodavimo agento ciklo organizatorių", tik jis neapsiriboja "galėjimu veikti", jam labiau rūpi "galite matyti, galite valdyti, galite atkurti".

Jo pagrindinis veikimo būdas yra labai paprastas:

• Jūs jam duodate krūvą užduočių (iš PRD ar iš kitos užduočių sistemos)
• Jis pasirenka aukščiausio prioriteto užduotį
• Sudaro prompt
• Paleidžia agentą vykdyti
• Nustato, ar užduotis laikoma atlikta
• Įrašo būseną
• Tęsia kitą ratą

Svarbiausia: visa tai galite matyti terminale ir bet kada sustabdyti, bet kada perimti. Oficialiai jo pozicionavimas taip pat yra labai aiškus: agento ciklo organizatorius su interaktyviu TUI, palaikantis TUI / headless / remote.

Kodėl sakau, kad jis labiau tinka "ilgalaikiam veikimui"?

Didžiausia scenarijaus ciklo problema yra ne tai, kad jis negali veikti, bet tai, kad nežinote, kur jis veikia.

Matote, kad žurnalai atsinaujina labai greitai, ventiliatorius taip pat sukasi gana laimingai, bet jūs nesate tikri:

• Ar jis kartoja tą pačią klaidą?
• Ar jis nuolat keičia tą patį kodo fragmentą ir vėl jį keičia?
• Ar jis jau baigė, bet neišėjo?
• Ar jis įstrigo kažkuriame teste ir sukasi begaliniame cikle?

ralph-tui sprendimas yra labai "inžinerinis":

• Yra sesijos sąvoka, būsena bus įrašyta į diską (.ralph-tui/session.json)
• Sugedus galima atkurti veikimą (crash recovery)
• Yra užrakto mechanizmas, kad išvengtumėte kelių instancijų atidarymo ir katalogo pavertimo tofu
• Taip pat galima headless paleisti CI, net remote atidaryti klausytoją nuotoliniame gale ir prisijungti prie jo vietiniu TUI

Vienu žodžiu: tai labiau panašu į "jūs valdote darbuotoją, kuris moka rašyti kodą", o ne "jūs stebite scenarijų, kuris išprotėjo".

Kaip įdiegti

ralph-tui rinkinys yra Bun/TypeScript ekosistema, todėl jį įdiegti gana paprasta. Oficialiai taip pat pateiktas diegimo puslapis.

Pirmiausia patikrinkite, ar jūsų kompiuteryje yra bun:

bun --version Tada įdiekite ralph-tui (čia pateikiu tipinį diegimo būdą, konkrečiai žiūrėkite oficialiame diegimo puslapyje):

bun add -g ralph-tui Baigę diegti, patikrinkite:

ralph-tui --help Jei esate Node šalininkas ir nenorite liesti bun, taip pat galite:

npm i -g ralph-tui

Pirmiausia nedarykite didelių dalykų, paleiskite minimalų uždarą ciklą

Siūlau pirmą kartą naudojant, iš karto nedaryti "viso repo pertvarkymo". Padarykite tik vieną dalyką: įsitikinkite, kad jis paleidžia mažą, priimtiną užduotį.

Inicializavimas

Atidarykite bet kurį katalogą:

mkdir ralph-tui-demo && cd ralph-tui-demo ralph-tui setup Tai pateks į interaktyvų vedlio procesą, kitaip tariant, "įdiegs ralph-tui į jūsų saugyklą", jis:

• Automatiškai aptinka, kokie agentai įdiegti jūsų kompiuteryje (pvz., Claude Code, OpenCode ir pan.)
• Projekte sukuria konfigūracijos failą: .ralph-tui/config.toml
• Iš karto įdiegia PRD generavimo / užduočių konvertavimo įgūdžius (vėliau jums nereikės patiems vargti)

Aš asmeniškai rekomenduoju: pirmą kartą nebūkite tingūs, setup būtinai paleiskite.

Projekto PRD generavimas

Kai setup baigtas, kitas žingsnis yra oficialios pamokos pagrindinis etapas, kuris taip pat labiausiai tinka rašyti demonstracinę versiją oficialioje paskyroje: create-prd.

ralph-tui create-prd --chat ši komanda įjungs dialoginį procesą, kuris, kaip produktų vadovas, klausinės jūsų apie poreikių tikslus, ribines sąlygas ir priėmimo kriterijus. Užbaigus klausimus, ji tiesiogiai išmes du dalykus projekte (tai yra svarbiausia):

• PRD markdown failą: ./tasks/prd-feature.md
• Tiesiogiai vykdomą užduoties failą: ./prd.json

Šiame etape jūs iš tikrųjų įeinate į „standartinį uždarą ratą“ ralph-tui:

Reikalavimai (PRD) → Užduotys (prd.json) → Vykdymas (run)

Paleidimas

Turint prd.json, paleisti tampa natūralu:

ralph-tui run --prd ./prd.json pamatysite, kad TUI paleidžiamas ir pradeda ciklą: pasirinkti užduotį → vykdyti → nustatyti, ar baigta → rašyti būseną → baigti arba kitas raundas.

Pirmą kartą paleidžiant, primygtinai rekomenduoju pridėti iteracijos apribojimą, pirmiausia uždarykite jį į narvą:

ralph-tui run --prd ./prd.json --iterations 5 paleidę peržiūrėkite pakeitimus, paleiskite testus, pažiūrėkite, ar PRD ir užduotys atitinka lūkesčius. Patvirtinkite, kad ši grandinė yra atvira, tada atleiskite iteracijas, tada įjunkite headless/remote, tai yra patikimas ritmas.

Šiuo metu galite iš esmės patvirtinti: šis ciklas tikrai veikia.

Kaip pasirinkti modelį / agentą? Apie pinigų taupymą reikia kalbėti atvirai

Aš žinau, kad daugelis žmonių labiausiai rūpinasi: „Ar galiu nenaudoti Claude Code? Ar galiu naudoti pigesnį modelį?“

Atsakymas yra: taip.

ralph-tui leidžia jums nurodyti agentą ir modelį (oficialioje run dokumentacijoje yra pavyzdžių).

Pavyzdžiui, naudojant Claude Opus:

ralph-tui run --prd ./prd.json --agent claude --model opus bet, tiesą sakant, aš pats nenaudočiau Opus „papildyti testus, taisyti lint“ tokiam darbui, tai per brangu. Mano įprotis yra suskirstyti į lygius:

• Pigūs modeliai: atlieka daug pasikartojančio darbo (papildyti testus, papildyti komentarus, taisyti formatą, pridėti ribas)
• Brangūs modeliai: pasirodo tik svarbiausiuose mazguose (architektūros koregavimas, sunkios klaidos, pagrindinė logika)

Jei esate paprastas kūrėjas, ši idėja yra dar svarbesnė. Kadangi jūs neturite didelės įmonės biudžeto, turite padaryti, kad išlaidos būtų kontroliuojamos, kad galėtumėte bėgti ilgai.

Norite būti dar patogesni? PRD rašymą taip pat perduokite agentui

ralph-tui turi man patinkantį dizainą: jis palaiko įgūdžius (tiesą sakant, tai yra agento išorinių komandų rinkinys).

Oficialus diegimo būdas yra naudoti add-skill:

bunx add-skill subsy/ralph-tui --all arba įdiegti į nurodytą agentą, pvz., claude-code:

bunx add-skill subsy/ralph-tui -a claude-code -g -y įdiegę galite naudoti slash komandą agento sesijoje:

/ralph-tui-prd /ralph-tui-create-json /ralph-tui-create-beads tai labai panašu į tai, kad IDE įdiegėte įskiepį, tik šis įskiepis skirtas agentui. Jo reikšmė yra sumažinti „žmonių rankų darbo poreikių perkėlimo“ laiką, kad poreikiai → užduotys → vykdymas būtų labiau panašūs į konvejerį.

Kada jį naudoti? Kada nenaudoti?Man nelabai patinka tas naratyvas, kad „viską galima padaryti su AI“, nes jis lengvai klaidina. Įrankis yra įrankis, vertingas tik tinkamoje situacijoje.

Scenarijai, kuriuose tinka naudoti ralph-tui

Turi krūvą tokio tipo darbų:

• Testų papildymas (ypač seniems projektams)
• Lint / format klaidų taisymas
• Maži refaktorizavimo žingsniai (pasikartojančio kodo sujungimas)
• Masinis tipų pridėjimas, ribų papildymas
• Reikalavimų išskaidymas ir lėtas stūmimas per užduočių eilę

Šie darbai turi bendrą bruožą: daug užduočių, didelis pasikartojamumas, galima patvirtinti, galima iteraciškai tobulinti.

Scenarijai, kuriuose neverta primygtinai naudoti ralph-tui

Kai reikia atlikti tokius darbus:

• Vienkartinis didelis refaktorizavimas, neaiškūs priėmimo kriterijai
• Pats reikalavimas neaiškus, remiasi jūsų paslėptomis žiniomis
• Reikia daug komandinio bendravimo / patvirtinimo
• Reikia priimti produkto sprendimus

Tokiu atveju agent loop tik padidins chaosą.

Kuo jis skiriasi nuo ralph-loop (ralph-claude-code)?

ralph-claude-code labiau primena „Claude Code autopiloto priedą“: scenarijus jį paleidžia, vykdo ciklą, išėjimo aptikimas, srauto ribojimas, grandinės pertraukiklis viskas pasirūpinta. Jei norite „greitai“, jis bus greitas.

ralph-tui labiau primena „agent loop inžinerinę valdymo pultą“: jis nepririša jokio konkretaus modelio ar užduočių sistemos. Jis nori išspręsti tokias inžinerines problemas kaip „ilgalaikis veikimas, stebėjimas, valdymas, atkūrimas, nuotolinis valdymas“.

Taigi, klausiate, kaip pasirinkti?

• Jūs esate Claude Code vartotojas ir norite greitai jį paleisti → ralph-claude-code
• Norite prijungti skirtingus modelius, sutaupyti pinigų, norite valdyti loop kaip paslaugą → ralph-tui

Pabaigai: neleiskite jam paversti jūsų saugyklos laboratorija

Aš pats turiu keletą griežtų taisyklių, kai paleidžiu agent loop. Užrašau jas čia, kad galėtumėte jomis vadovautis, ir avarijos tikimybė bus daug mažesnė:

• Vykdykite šakoje, nežaiskite su pagrindine šaka.
• Pirmą kartą paleidžiant būtinai pridėkite --iterations, kad patvirtintumėte, jog jis neišprotės.
• Užduotis turi būti patvirtinama: arba gali vykdyti testus, arba gali vykdyti lint, arba gali palyginti išvesties failus.
• Turite išmokti sustoti: pamatę, kad jis pradeda suktis ratu, sustabdyti yra protingiau nei toliau deginti pinigus.
• Pigūs modeliai atlieka sunkų darbą, brangūs modeliai atlieka svarbų darbą: kaina yra operacijų rezultatas, o ne maldos rezultatas.Projekto adresas: https://github.com/subsy/ralph-tui