Konačno je stiglo ono što ste tražili! Ralph TUI, vizualizacija Ralph Loop-a

Prethodno sam napisao tutorijal o ralph-loop, a mnogi prijatelji koji su ga isprobali su imali slične povratne informacije: Super je, Claude Code konačno može da radi duže vreme. Ali ponekad, kada ga posmatrate, izgleda kao da se ne pomera, pa se neizbežno pitate: "Da li napreduje ili se vrti u krug?"

To je razlog zašto sam se nedavno bavio ralph-tui.

ralph-tui ne nameće obavezno korišćenje Claude Code-a, već nasleđuje i razvija suštinu ralph loop-a, i vizualizuje izvršavanje zadataka i proces, što značajno smanjuje prepreke za dugotrajan rad velikih modela. Možete koristiti druge agente, druge modele, domaće, jeftine, one koje možete dugoročno da pokrećete. Sa ralph-tui, za nas obične ljude, to je kao prelazak sa manuelnog menjača na automatski sa tempomatom.

Šta je to zapravo?

Možete zamisliti ralph-tui kao "ciklični aranžer AI coding agenta", samo što nije zadovoljan time da "može da radi", već mu je važnije da "možete da vidite, kontrolišete i oporavite".

Njegov osnovni način rada je prilično jednostavan:

• Dajete mu gomilu zadataka (može iz PRD-a, može iz drugog sistema zadataka)
• On bira onaj sa najvišim prioritetom
• Sastavlja prompt
• Pokreće agenta da ga izvrši
• Procenjuje da li je zadatak završen
• Upisuje status
• Nastavlja sa sledećim krugom

Poenta je: sve ovo možete da vidite u terminalu, i možete da ga zaustavite i preuzmete kontrolu u bilo kom trenutku. Zvanično je definisan kao: agent loop orchestrator sa interaktivnim TUI-jem, koji podržava TUI / headless / remote.

Zašto kažem da je pogodniji za "dugoročno pokretanje"?

Najveći problem sa skriptama koje pokreću loop nije to što ne mogu da se pokrenu, već to što ne znate dokle su stigle.

Gledate kako se logovi brzo ispisuju, a ventilator se veselo vrti, ali niste sigurni:

• Da li ponavlja popravljanje istog baga?
• Da li stalno menja isti deo koda, pa ga vraća nazad?
• Da li je već završio, samo nije izašao?
• Da li je zaglavljen u nekom testu u beskonačnoj petlji?

Rešenje ralph-tui je vrlo "inženjersko":

• Ima koncept sesije, status se čuva na disku (.ralph-tui/session.json)
• Može da se oporavi od pada (crash recovery)
• Ima mehanizam zaključavanja, da se izbegne da više instanci pokvare direktorijum
• Može da se pokrene headless u CI, ili čak remote, da se otvori listener na udaljenom serveru, a lokalni TUI se poveže na njega

Ukratko: Više liči na to da "upravljate radnikom koji zna da piše kod", nego da "gledate kako skripta poludi".

Kako se instalira

ralph-tui je Bun/TypeScript ekosistem, tako da je instalacija prilično jednostavna. Zvanična stranica takođe ima uputstva za instalaciju.

Prvo proverite da li imate bun na svom računaru:

bun --versionZatim instalirajte ralph-tui (ovde dajem tipičan način instalacije, pogledajte zvaničnu stranicu za detalje):

bun add -g ralph-tuiNakon instalacije, proverite:

ralph-tui --helpAko ste Node fan, i ne želite da koristite bun, može i ovako:

npm i -g ralph-tui

Nemojte odmah raditi velike stvari, pokrenite minimalni zatvoreni krug

Preporučujem da, kada ga koristite prvi put, ne radite odmah nešto kao "refaktorišite ceo repo". Uradite samo jednu stvar: Neka prođe mali zadatak koji se može prihvatiti.

Inicijalizacija

Otvorite bilo koji direktorijum:

mkdir ralph-tui-demo && cd ralph-tui-demo ralph-tui setupOvo će ući u interaktivni proces, što znači "instaliranje ralph-tui u ovaj repozitorijum", on će:

• Automatski detektuje koje agente imate instalirane na vašem računaru (kao što su Claude Code, OpenCode, itd.)
• Generiše konfiguracioni fajl u projektu: .ralph-tui/config.toml
• Usput instalira skills vezane za generisanje PRD-a/konverziju zadataka (tako da ne morate sami da se mučite kasnije)

Moja lična preporuka: Nemojte biti lenji prvi put, obavezno pokrenite setup.

Generisanje PRD-a projekta

Nakon što se setup završi, sledeći korak je najvažniji deo zvaničnog tutorijala, koji je takođe najpogodniji za pisanje demo-a za blog: create-prd.

ralph-tui create-prd --chat ova komanda će ući u interaktivni proces, gde će vas ispitivati kao product manager o ciljevima zahteva, graničnim uslovima i kriterijumima prihvatanja. Nakon što završi sa ispitivanjem, direktno će izbaciti dve stvari u projektu (ovo je ključno):

• Markdown fajl PRD-a: ./tasks/prd-feature.md
• Fajl zadataka koji se može direktno izvršiti: ./prd.json

U ovom koraku, zaista ulazite u "standardni zatvoreni krug" ralph-tui-a:

Zahtev (PRD) → Zadatak (prd.json) → Izvršavanje (run)

Pokretanje (run)

Sa prd.json, pokretanje (run) je prirodan nastavak:

ralph-tui run --prd ./prd.json videćete da se TUI pokreće i započinje petlju: bira zadatak → izvršava → procenjuje završetak → piše status → završava ili prelazi na sledeći krug.

Prilikom prvog pokretanja, toplo preporučujem da dodate gornju granicu iteracija, da ga prvo zatvorite u kavez:

ralph-tui run --prd ./prd.json --iterations 5 Nakon pokretanja, pogledajte promene, pokrenite testove, proverite da li PRD i zadaci ispunjavaju očekivanja. Potvrdite da je ova veza ispravna, a zatim oslobodite iteracije, pređite na headless/remote, to je pouzdan ritam.

U ovom trenutku, u osnovi možete potvrditi: Ova petlja zaista radi.

Kako odabrati model/Agent? O uštedi novca treba biti iskren

Znam da je mnoge najviše briga: "Mogu li da ne koristim Claude Code? Mogu li da koristim jeftinije modele?"

Odgovor je: Da.

ralph-tui vam omogućava da navedete agenta i model (zvanična run dokumentacija ima primere).

Na primer, koristite Claude Opus:

ralph-tui run --prd ./prd.json --agent claude --model opus Ali iskreno, ja lično ne bih koristio Opus za "dopunu testova, popravku lint-a", preskupo je. Moja navika je slojevita:

• Jeftini modeli: Pokreću veliki broj ponavljajućih poslova (dopuna testova, dopuna komentara, popravka formata, dodavanje granica)
• Skupi modeli: Pojavljuju se samo u ključnim tačkama (prilagođavanje arhitekture, teški bagovi, ključna logika)

Ako ste običan programer, ovaj način razmišljanja je još važniji. Zato što nemate budžet velike kompanije, morate da kontrolišete troškove da biste mogli da radite duže.

Želite da bude još bolje? Prepustite i "pisanje PRD-a" agentu

ralph-tui ima dizajn koji mi se sviđa: podržava skills (u suštini, to je skup spoljnih komandi za agenta).

Zvanični način instalacije je korišćenjem add-skill:

bunx add-skill subsy/ralph-tui --all Ili instalirajte na određenog agenta, na primer claude-code:

bunx add-skill subsy/ralph-tui -a claude-code -g -y Nakon instalacije, možete koristiti slash komande u sesiji agenta:

/ralph-tui-prd /ralph-tui-create-json /ralph-tui-create-beads Ovo je kao da ste instalirali dodatak u IDE, samo što je ovaj dodatak za agenta. Njegova svrha je da smanji vreme "ručnog prenošenja zahteva", čineći da zahtev → zadatak → izvršavanje više liči na proizvodnu traku.

Kada ga treba koristiti? Kada ga ne treba koristiti?Не волим баш наратив "све се може решити помоћу вештачке интелигенције", јер је склон да заведе. Алат је само алат, вреди само у одговарајућим сценаријима.

Сценарији у којима је 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
• Желите да повежете различите моделе, желите да уштедите новац, желите да управљате loop-ом као сервисом → ralph-tui

На крају: Не дозволите да вам складиште буде лабораторија

Имам неколико гвоздених правила за покретање agent loop-а, написаћу их овде и ви их се придржавајте, шансе за неуспех ће бити много мање:

• Покрените на гранама, не играјте се животом на main-у.
• Када га први пут покрећете, обавезно додајте --iterations, прво потврдите у малим корацима да неће полудети.
• Задаци морају бити прихватљиви: или могу да покрену тестове, или могу да покрену lint, или могу да упореде излазне датотеке.
• Морате научити да станете: када видите да почиње да се врти у круг, паметније је да паузирате него да наставите да трошите новац.
• Јефтини модели раде грубе послове, скупи модели раде кључне послове: трошкови се управљају, не моле се за њих.Адреса пројекта: https://github.com/subsy/ralph-tui