Konečne je to tu! Ralph TUI, vizualizácia Ralph Loop

Predtým som napísal tutoriál o ralph-loop, a mnohí priatelia, ktorí ho vyskúšali, mali podobnú spätnú väzbu: Je to super, Claude Code konečne môže bežať dlhú dobu. Ale niekedy, keď ho pozorujete, zdá sa, že sa nehýbe, a v srdci máte pochybnosti: "Posúva sa dopredu, alebo sa točí na mieste?"

To je dôvod, prečo som sa nedávno zaoberal ralph-tui.

ralph-tui nie je povinne viazaný na Claude Code, dedí a rozvíja podstatu ralph loop a vizualizuje vykonávanie úloh a proces, čím výrazne znižuje prah pre dlhodobú prácu rozsiahlych modelov. Môžete pripojiť iného agenta, iný model, domáci, lacný, taký, ktorý si môžete dlhodobo dovoliť spustiť. S ralph-tui je to pre nás, bežných ľudí, významné ako prechod z manuálnej prevodovky na automatickú s tempomatom.

Čo to vlastne je?

ralph-tui si môžete predstaviť ako "cyklický orchestrátor AI coding agenta", lenže sa neuspokojí s tým, že "dokáže bežať", viac sa zameriava na to, že "vidíte, ovládate, obnovujete".

Jeho základný spôsob práce je veľmi jednoduchý:

• Dáte mu hromadu úloh (môžu pochádzať z PRD, alebo z iného systému úloh)
• Vyberie tú s najvyššou prioritou
• Zostaví prompt
• Spustí agenta na vykonanie
• Posúdi, či je úloha dokončená
• Zapíše stav
• V ďalšom kole pokračuje

Dôležité je: toto všetko môžete vidieť v termináli a môžete kedykoľvek zastaviť, kedykoľvek prevziať kontrolu. Oficiálne je jeho pozícia napísaná veľmi priamo: agent loop orchestrator s interaktívnym TUI, ktorý podporuje TUI / headless / remote.

Prečo hovorím, že je vhodnejší na "dlhodobé spustenie"?

Najväčší problém so skriptom spúšťajúcim loop nie je, že sa nedá spustiť, ale že neviete, kde sa nachádza.

Vidíte, že sa logy rýchlo aktualizujú a ventilátor sa točí, ale nie ste si istí:

• Opravuje opakovane tú istú chybu?
• Neustále upravuje ten istý kód a potom ho vracia späť?
• Už to dokončil, len neukončil?
• Zasekol sa v nejakom teste v nekonečnej slučke?

ralph-tui má veľmi "inžinierske" riešenie:

• Má koncept session, stav sa ukladá na disk (.ralph-tui/session.json)
• Ak sa zrúti, môže sa obnoviť (crash recovery)
• Má mechanizmus zámku, aby ste predišli tomu, že spustíte viacero inštancií a zničíte adresár
• Môže sa spustiť aj headless v CI, alebo dokonca remote spustiť listener na vzdialenom konci a lokálne TUI sa k nemu pripojí

Jedna veta: Je to skôr, ako by ste "riadiť robotníka, ktorý vie písať kód", než "sledovať skript, ktorý sa zbláznil".

Ako nainštalovať

Táto sada ralph-tui je ekosystém Bun/TypeScript, takže inštalácia je celkom jednoduchá. Oficiálna stránka tiež poskytuje stránku inštalácie.

Najprv sa uistite, že máte na svojom stroji bun:

bun --versionPotom nainštalujte ralph-tui (tu uvádzam typickú inštaláciu, konkrétne si pozrite oficiálnu stránku inštalácie):

bun add -g ralph-tuiPo inštalácii skontrolujte:

ralph-tui --helpAk ste fanúšikom Node a nechcete sa dotknúť bun, môžete to urobiť aj takto:

npm i -g ralph-tui

Najprv nerobte veľké veci, spustite minimálny uzavretý cyklus

Odporúčam, aby ste pri prvom použití nerobili hneď "refaktorovanie celého repozitára". Urobte len jednu vec: Uistite sa, že beží malá, akceptovateľná úloha.

Inicializácia

Otvorte ľubovoľný adresár:

mkdir ralph-tui-demo && cd ralph-tui-demo ralph-tui setupTýmto sa spustí interaktívny sprievodca, ktorý v podstate "nainštaluje ralph-tui do tohto repozitára", urobí:

• Automaticky zistí, ktoré agenty máte nainštalované na svojom stroji (napríklad Claude Code, OpenCode atď.)
• Vygeneruje konfiguračný súbor v projekte: .ralph-tui/config.toml
• Rovno nainštaluje zručnosti súvisiace s generovaním PRD/konverziou úloh (neskôr sa s tým nebudete musieť manuálne trápiť)

Osobne odporúčam: na prvýkrát nebuďte leniví, setup musíte spustiť celý.

Generovanie PRD projektu

Po spustení setupu je ďalším krokom najdôležitejšia časť oficiálneho tutoriálu, ktorá je tiež najvhodnejšia na napísanie demo pre verejnosť: create-prd.

Príkaz ralph-tui create-prd --chat spustí konverzačný proces, ktorý sa vás bude ako produktový manažér vypytovať na ciele, okrajové podmienky a akceptačné kritériá. Po vypýtaní vygeneruje priamo dve veci v projekte (a to je to hlavné):

• Markdown súbor PRD: ./tasks/prd-feature.md
• Súbor úloh, ktorý je pripravený na spustenie: ./prd.json

V tomto kroku ste skutočne vstúpili do "štandardného uzavretého cyklu" ralph-tui:

Požiadavka (PRD) → Úloha (prd.json) → Spustenie (run)

Spustenie

S prd.json je spustenie prirodzené:

ralph-tui run --prd ./prd.json uvidíte, že sa spustí TUI a začne sa cyklus: výber úlohy → vykonanie → posúdenie dokončenia → zápis stavu → ukončenie alebo ďalšie kolo.

Pri prvom spustení dôrazne odporúčam pridať limit iterácií, najprv ho zatvorte do klietky:

ralph-tui run --prd ./prd.json --iterations 5 Po spustení si pozrite zmeny, spustite testy, skontrolujte, či PRD a úlohy spĺňajú očakávania. Potvrďte, že je táto cesta priechodná, potom uvoľnite iterácie, potom prejdite na headless/remote, to je spoľahlivý rytmus.

V tomto momente si v podstate môžete potvrdiť: Tento cyklus skutočne beží.

Ako si vybrať model/agenta? O šetrení peňazí treba hovoriť úprimne

Viem, že mnohých najviac zaujíma: "Môžem nepoužívať Claude Code? Môžem použiť lacnejší model?"

Odpoveď je: Áno.

Samotný ralph-tui vám umožňuje určiť agenta a model (oficiálna dokumentácia run obsahuje príklady).

Napríklad pomocou Claude Opus:

ralph-tui run --prd ./prd.json --agent claude --model opus Ale úprimne, ja by som nepoužil Opus na "doplnenie testov, opravu lint", je to príliš drahé. Mám zvyk rozdeľovať to do vrstiev:

• Lacné modely: spúšťajú veľa opakujúcej sa práce (doplnenie testov, doplnenie komentárov, oprava formátu, pridanie hraníc)
• Drahé modely: objavujú sa len v kľúčových bodoch (úprava architektúry, zložité chyby, základná logika)

Ak ste bežný vývojár, tento prístup je ešte dôležitejší. Pretože nemáte rozpočet veľkej spoločnosti, musíte mať náklady pod kontrolou, aby ste mohli bežať dlho.

Chcete to ešte lepšie? Prenechajte "písanie PRD" agentovi

ralph-tui má dizajn, ktorý sa mi veľmi páči: podporuje skills (v podstate ide o sadu externých príkazov pre agenta).

Oficiálny spôsob inštalácie je pomocou add-skill:

bunx add-skill subsy/ralph-tui --all Alebo nainštalujte do určeného agenta, napríklad claude-code:

bunx add-skill subsy/ralph-tui -a claude-code -g -y Po inštalácii môžete v konverzácii s agentom použiť slash command:

/ralph-tui-prd /ralph-tui-create-json /ralph-tui-create-beads Je to ako keby ste si nainštalovali plugin do IDE, len tento plugin je určený pre agenta. Jeho význam spočíva v skrátení času "manuálneho prenosu požiadaviek", vďaka čomu sa požiadavka → úloha → vykonanie viac podobá výrobnej linke.

Kedy by ste ho mali použiť? Kedy nie?Nemám veľmi rád ten naratív „všetko sa dá zvládnuť pomocou AI“, je zavádzajúci. Nástroj je len nástroj, cenný je len vtedy, keď sa hodí do danej situácie.

Scenáre vhodné pre použitie ralph-tui

Máte hromadu takejto práce:

• Doplnenie testov (hlavne staré projekty)
• Oprava lint / formátovanie
• Drobné refaktorovanie (zjednotenie opakujúceho sa kódu)
• Hromadné pridávanie typov, doplnenie okrajových prípadov
• Rozdelenie požiadaviek a postupné posúvanie podľa frontu úloh

Tieto úlohy majú spoločné to, že: Je ich veľa, sú vysoko opakujúce sa, dajú sa overiť, dajú sa iteratívne posúvať.

Scenáre, kde sa nehodí nasilu použiť ralph-tui

Ak robíte toto:

• Jednorazové rozsiahle refaktorovanie, nejasné kritériá akceptácie
• Samotná požiadavka je nejasná, spoliehate sa na vaše implicitné znalosti
• Vyžaduje si rozsiahlu komunikáciu/potvrdenie medzi tímami
• Vyžaduje si vaše produktové rozhodovanie

V takýchto úlohách agent loop len zväčší chaos.

Aký je rozdiel medzi ním a ralph-loop (ralph-claude-code)?

ralph-claude-code je skôr ako „autopilot pre Claude Code“: skript ho spustí, beží v slučke, detekcia ukončenia, obmedzenie rýchlosti, ističe sú vám k dispozícii. Chcete „rýchlosť“, a on je rýchly.

ralph-tui je skôr ako „inžinierska konzola pre agent loop“: nie je napevno pripojený k žiadnemu modelu, ani k žiadnemu systému úloh. Snaží sa riešiť inžinierske problémy ako „dlhodobé spustenie, pozorovateľnosť, ovládateľnosť, obnoviteľnosť, vzdialená správa“.

Takže sa ma pýtate, ako si vybrať?

• Ste používateľ Claude Code a chcete ho rýchlo spustiť → ralph-claude-code
• Chcete pripojiť rôzne modely, chcete ušetriť peniaze, chcete spravovať loop ako službu → ralph-tui

Nakoniec: Nenechajte ho používať váš repozitár ako laboratórium

Mám niekoľko železných pravidiel pre vlastné spúšťanie agent loop, napíšem ich sem, aby ste sa nimi riadili, pravdepodobnosť zlyhania bude oveľa menšia:

• Spúšťajte na vetve, nehrajte sa na main.
• Pri prvom spustení vždy pridajte --iterations, najprv malými krokmi potvrďte, že sa nezblázni.
• Úloha musí byť akceptovateľná: buď môže spustiť testy, alebo môže spustiť lint, alebo môže porovnať výstupné súbory.
• Musíte sa naučiť zastaviť: keď vidíte, že začína krúžiť, je múdrejšie pozastaviť ako pokračovať v míňaní peňazí.
• Lacné modely robia hrubú prácu, drahé modely robia kľúčovú prácu: náklady sa prevádzkujú, nie sa za ne modlia.Adresa projektu: https://github.com/subsy/ralph-tui