Lõpuks on see siin! Ralph TUI, Ralph Loopi visualiseerimine

Ma kirjutasin varem õpetuse ralph-loop kohta ja paljud sõbrad, kes selle läbi jooksutasid, andsid üsna ühtset tagasisidet: Väga hea, Claude Code saab lõpuks pikalt töötada. Aga mõnikord sa vaatad seda ja see tundub liikumatuna, sa ei saa jätta mõtlemata: "Kas see liigub edasi või keerleb paigal?"

See on põhjus, miks ma olen viimasel ajal ralph-tui-ga jamanud.

ralph-tui ei ole sunnitud siduma Claude Code'iga, see pärib ja arendab ralph loopi olemust ning visualiseerib ülesannete täitmise ja protsessi, vähendades oluliselt läve suurte mudelite pikaajaliseks tööks. Sa võid täiesti ühendada teisi agente, teisi mudeleid, kodumaiseid, odavaid, selliseid, mida sa saad pikalt jooksutada. Ralph-tui'ga on see meie tavaliste inimeste jaoks sama, mis manuaalkäigukastilt automaatkäigukastile üleminek koos püsikiirusehoidjaga.

Mis see täpselt on?

Sa võid mõelda ralph-tui'le kui "AI kodeerimisagendi tsüklikorraldajale", aga see ei ole rahul sellega, et "saab jooksutada", see on rohkem huvitatud sellest, et "sa näed, saad kontrollida, saad taastada".

Selle põhiline tööpõhimõte on väga lihtne:

• Sa annad sellele hunniku ülesandeid (kas PRD-st või mõnest muust ülesandesüsteemist)
• See valib kõige kõrgema prioriteediga ülesande
• Paneb kokku prompti
• Käivitab agendi, et seda täita
• Hindab, kas see ülesanne on lõpetatud
• Kirjutab oleku
• Järgmine voor jätkub

Põhiline on: sa näed seda kõike terminalis ja saad igal ajal peatada, igal ajal üle võtta. Selle ametlik positsioon on ka väga otsekohene: interaktiivse TUI-ga agendi loop orchestrator, mis toetab ka TUI / headless / remote.

Miks ma ütlen, et see sobib paremini "pikaajaliseks jooksutamiseks"?

Skripti loopi jooksutamise suurim probleem ei ole see, et see ei saa käima, vaid see, et sa ei tea, kus see jookseb.

Sa näed, et logid jooksevad kiiresti, ventilaator töötab ka rõõmsalt, aga sa ei ole kindel:

• Kas see kordab sama vea parandamist?
• Kas see muudab pidevalt sama koodilõiku ja siis muudab selle tagasi?
• Kas see on juba lõpetatud, aga ei ole väljunud?
• Kas see on kinni jäänud mingile testile ja jookseb lõpmatus tsüklis?

ralph-tui lahendus on väga "insenerlik":

• On sessiooni kontseptsioon, olek salvestatakse kettale (.ralph-tui/session.json)
• Kui see kokku jookseb, saab seda taastada (crash recovery)
• On lukustusmehhanism, et vältida mitme eksemplari avamist, mis kataloogi segamini ajavad
• Saab ka headless režiimis CI-s jooksutada, isegi remote režiimis avada listeneri kauges otsas ja ühendada kohaliku TUI-ga

Ühesõnaga: see on rohkem nagu "sa juhid kodeerivat töölist" kui "sa jälgid skripti, mis on hulluks läinud".

Kuidas installida

ralph-tui komplekt on Bun/TypeScript ökosüsteem, seega on selle installimine üsna lihtne. Ametlikult on ka installileht.

Kõigepealt veendu, et su masinas on bun:

bun --versionseejärel installi ralph-tui (ma annan siin tüüpilise installimise, täpsemalt vaata ametlikku installilehte):

bun add -g ralph-tuiPärast installimist kontrolli:

ralph-tui --helpKui sa oled Node'i fänn ja ei taha bun'iga tegeleda, siis ka sobib:

npm i -g ralph-tui

Ära kohe suurt asja tee, jooksuta kõige väiksemat suletud tsüklit

Ma soovitan esmakordsel kasutamisel mitte kohe midagi "terve repo ümberstruktureerimist" teha. Sa tee ainult üks asi: lase sellel läbida väike vastuvõetav ülesanne.

Initsialiseerimine

Ava suvaline kataloog:

mkdir ralph-tui-demo && cd ralph-tui-demo ralph-tui setupSee viib sind interaktiivse juhendi protsessi, mis on sisuliselt "ralph-tui installimine sellesse hoidlasse", see teeb:

• Automaatselt tuvastab, millised agendid on sinu masinasse installitud (näiteks Claude Code, OpenCode jne)
• Genereerib projekti konfiguratsioonifaili: .ralph-tui/config.toml
• Installib PRD genereerimise/ülesannete teisendamisega seotud skills (sa ei pea hiljem ise jändama)

Minu isiklik soovitus: esimesel korral ära ole laisk, setup tuleb kindlasti läbi teha.

Projekti PRD genereerimine

Kui setup on tehtud, on järgmine samm ametliku õpetuse kõige olulisem osa, mis sobib ka hästi avaliku demo jaoks: create-prd.

ralph-tui create-prd --chat käsk käivitab dialoogiprotsessi, mis küsib sinult nagu tootejuht nõuete eesmärkide, piirangute ja vastuvõtukriteeriumide kohta. Pärast küsimuste esitamist loob see projekti kaks asja (see on peamine):

• PRD markdown-fail: ./tasks/prd-feature.md
• Otse käivitatav ülesannete fail: ./prd.json

Selles etapis oled sa tõeliselt sisenenud ralph-tui "standardse suletud ahelasse":

Nõue (PRD) → Ülesanne (prd.json) → Täitmine (run)

Käivitamine (run)

Kui sul on prd.json, on käivitamine loogiline jätk:

ralph-tui run --prd ./prd.json Sa näed, et TUI käivitub ja alustab loop'i: vali ülesanne → täida → otsusta, kas on valmis → kirjuta olek → lõpeta või mine järgmisele ringile.

Esimesel käivitamisel soovitan tungivalt lisada iteratsioonide ülempiiri, et see esialgu puuris hoida:

ralph-tui run --prd ./prd.json --iterations 5 Pärast käivitamist vaata muudatusi, käivita teste, vaata, kas PRD ja ülesanded vastavad ootustele. Kui oled veendunud, et see ahel on toimiv, siis vabasta iteratsioonid, mine üle headless/remote režiimile, see on usaldusväärne lähenemine.

Sel hetkel saad sa põhimõtteliselt kinnitada: see loop töötab tõesti.

Kuidas valida mudelit/agenti? Raha säästmise kohta tuleb ausalt rääkida

Ma tean, et paljusid huvitab kõige rohkem: "Kas ma saan ilma Claude Code'ita hakkama? Kas ma saan kasutada odavamaid mudeleid?"

Vastus on: Jah.

ralph-tui ise toetab agendi ja mudeli määramist (ametlikus run dokumentatsioonis on näiteid).

Näiteks kasutades Claude Opus't:

ralph-tui run --prd ./prd.json --agent claude --model opus Aga ausalt öeldes, ma ise ei kasutaks Opus't selliste tööde jaoks nagu "testide täiendamine, lint'i parandamine", see on liiga kallis. Minu harjumus on kihistamine:

• Odavad mudelid: teevad palju korduvat tööd (testide täiendamine, kommentaaride lisamine, formaadi parandamine, piiride lisamine)
• Kallid mudelid: osalevad ainult kriitilistes punktides (arhitektuuri kohandamine, rasked vead, põhilogika)

Kui sa oled tavaline arendaja, on see lähenemine veelgi olulisem. Sest sul ei ole suurettevõtte eelarvet, sa pead hoidma kulud kontrolli all, et saaksid kaua jätkata.

Tahad veelgi paremat kogemust? Anna ka "PRD kirjutamine" agendile

ralph-tui'l on disain, mis mulle väga meeldib: see toetab skills (põhimõtteliselt on see agendi välised käsud).

Ametlik installimisviis on add-skill:

bunx add-skill subsy/ralph-tui --all Või installi see kindlale agendile, näiteks claude-code:

bunx add-skill subsy/ralph-tui -a claude-code -g -y Pärast installimist saad sa agendi vestluses kasutada slash command'eid:

/ralph-tui-prd /ralph-tui-create-json /ralph-tui-create-beads See on nagu IDE'sse pistikprogrammi installimine, ainult et see pistikprogramm on mõeldud agendile. Selle eesmärk on vähendada "inimtööjõuga nõuete teisaldamise" aega, muutes nõuded → ülesanded → täitmine rohkem nagu konveierliin.

Millal seda kasutada? Millal mitte?Ma ei ole eriti vaimustatud narratiivist "AI-ga saab kõike teha", see on eksitav. Tööriist on tööriist ja väärtuslik ainult sobivas kontekstis.

Millal on ralph-tui kasutamine sobiv?

Sul on hunnik selliseid ülesandeid:

• Testide täiendamine (eriti vanade projektide puhul)
• Lintimis-/vormindusvigade parandamine
• Väikesed refaktorid (korduva koodi kokkuviimine)
• Hulgi tüüpide lisamine, piiride täiendamine
• Nõuete dekonstrueerimine ja ülesannete järjekorras aeglane edasiliikumine

Neil ülesannetel on ühine joon: palju ülesandeid, kõrge korduvusaste, vastuvõetav, iteratiivselt edasiviidav.

Millal ei ole mõtet ralph-tui'd peale suruda?

Kui sa teed selliseid asju:

• Ühekordne suur refaktor, mille vastuvõtukriteeriumid on ebaselged
• Nõue ise on ebamäärane, tuginedes sinu aju varjatud teadmistele
• Vajalik on palju meeskondadevahelist suhtlust/kinnitust
• Vajalik on sinu tooteotsus

Selliste ülesannete puhul agent loop ainult võimendab segadust.

Mis on selle erinevus ralph-loop'ist (ralph-claude-code)?

ralph-claude-code on rohkem nagu "Claude Code'i automaatpiloodi lisandmoodul": skript käivitab selle, käitab tsüklit, väljumise tuvastamine, piiramine ja kaitselüliti on kõik sinu jaoks tagatud. Sa tahad "kiirust", see ongi kiire.

ralph-tui on rohkem nagu "agent loop'i insenerikonsool": see ei ole kinni keevitatud ühegi mudeli külge ega ka ühegi ülesandesüsteemi külge. See püüab lahendada selliseid inseneriprobleeme nagu "pikaajaline käitamine, jälgitavus, juhitavus, taastatavus, kaugjuhtimine".

Nii et sa küsid, kuidas valida?

• Sa oled Claude Code'i kasutaja ja sa tahad, et see kiiresti tööle hakkaks → ralph-claude-code
• Sa tahad ühendada erinevaid mudeleid, sa tahad raha säästa, sa tahad loop'i teenusena hallata → ralph-tui

Lõpetuseks: ära lase sellel oma hoidlat laborina kasutada

Mul on agent loop'i käitamisel mõned raudsed reeglid, kirjutan need siia, et sa saaksid neid järgida ja õnnetuste tõenäosus on palju väiksem:

• Kasuta haru, ära mängi main'is eluga.
• Esimene käivitus peab sisaldama --iterations, et kõigepealt väikeste sammudega kinnitada, et see ei lähe hulluks.
• Ülesanne peab olema vastuvõetav: kas saab testida, lintida või võrrelda väljundfaile.
• Sa pead õppima peatuma: kui sa näed, et see hakkab ringi käima, on peatamine targem kui raha põletamine.
• Odavad mudelid teevad musta tööd, kallid mudelid teevad kriitilist tööd: kulu on opereerimise tulemus, mitte palve tulemus.Projekti aadress: https://github.com/subsy/ralph-tui