Beidzot tas ir klāt! Ralph TUI, Ralph Loop vizualizācija

Esmu iepriekš rakstījis pamācību par ralph-loop, un daudzi draugi, kuri to izmēģināja, sniedza vienādu atsauksmi: Ir forši, Claude Code beidzot var darboties ilgu laiku. Bet dažreiz, vērojot to, šķiet, ka tas nemaz nekustas, un sirdī rodas šaubas: "Vai tas virzās uz priekšu, vai griežas uz vietas?"

Tas ir iemesls, kāpēc esmu pēdējā laikā ņēmies ar ralph-tui.

ralph-tui neuzspiež Claude Code saistību, tas manto un attīsta ralph loop būtību, un vizualizē uzdevumu izpildi un procesu, ievērojami samazinot barjeru, lai lielie modeļi darbotos ilgstoši. Jūs varat pilnībā pievienot citus aģentus, citus modeļus, vietējos, lētus, tādus, kurus varat atļauties darbināt ilgtermiņā. Ar ralph-tui mums, parastajiem cilvēkiem, tas ir tikpat svarīgi kā pāreja no manuālās pārnesumkārbas uz automātisko ar kruīza kontroli.

Kas tas īsti ir?

Jūs varat uztvert ralph-tui kā "AI kodēšanas aģenta cikla organizatoru", bet tas neapmierinās tikai ar "spēju darboties", tas vairāk rūpējas par "spēju redzēt, kontrolēt un atjaunot".

Tā pamatdarbības veids ir ļoti vienkāršs:

• Jūs iedodat tam uzdevumu kaudzi (var ņemt no PRD, var ņemt no citām uzdevumu sistēmām)
• Tas izvēlas prioritārāko
• Saliek prompt
• Palaiž aģentu, lai izpildītu
• Nosaka, vai uzdevums ir pabeigts
• Ieraksta statusu
• Nākamajā kārtā turpina

Galvenais ir: to visu jūs varat redzēt terminālī, un jūs varat jebkurā laikā apstāties un pārņemt kontroli. Oficiāli tas arī ir definēts ļoti vienkārši: aģenta cikla organizators ar interaktīvu TUI, un atbalsta TUI / headless / remote.

Kāpēc es saku, ka tas ir piemērotāks "ilgtermiņa darbībai"?

Lielākā problēma ar skripta palaišanu ciklā nav tā, ka to nevar palaist, bet gan tā, ka jūs nezināt, kur tas ir nonācis.

Jūs redzat, ka žurnāli tiek atjaunināti ļoti ātri, un ventilators arī griežas diezgan priecīgi, bet jūs neesat pārliecināts:

• Vai tas neatkārtoti labo vienu un to pašu kļūdu?
• Vai tas nepārtraukti maina vienu un to pašu koda fragmentu un pēc tam atkal to maina?
• Vai tas jau ir pabeigts, bet vienkārši nav izgājis?
• Vai tas nav iestrēdzis kādā testā bezgalīgā ciklā?

ralph-tui risinājums ir ļoti "inženierisks":

• Ir sesijas jēdziens, statuss tiks saglabāts diskā (.ralph-tui/session.json)
• Ja tas avarē, to var atjaunot (crash recovery)
• Ir bloķēšanas mehānisms, lai izvairītos no vairāku instanču atvēršanas un direktorijas sajaukšanas
• To var pat palaist headless CI, vai pat remote atvērt listener attālināti, un vietējais TUI var pieslēgties

Vienā teikumā: Tas vairāk atgādina "jūs pārvaldāt strādnieku, kurš prot rakstīt kodu", nevis "jūs vērojat skriptu, kas raustās".

Kā instalēt

ralph-tui komplekts ir Bun/TypeScript ekosistēma, tāpēc to instalēt ir diezgan ērti. Oficiālā vietne arī sniedz instalēšanas lapu.

Vispirms pārliecinieties, vai jūsu datorā ir bun:

bun --version pēc tam instalējiet ralph-tui (es šeit sniedzu tipisku instalēšanas metodi, konkrēti skatiet oficiālo instalēšanas lapu):

bun add -g ralph-tui Pēc instalēšanas pārbaudiet:

ralph-tui --help Ja esat Node cienītājs un nevēlaties izmantot bun, tas ir arī iespējams:

npm i -g ralph-tui

Nedarbojieties uzreiz ar lielām lietām, palaidiet minimālu slēgtu ciklu

Es iesaku pirmajā reizē neuzreiz darīt kaut ko tādu kā "pārstrukturēt visu repo". Jums jādara tikai viena lieta: Panākt, lai tas izpildītu mazu, pieņemamu uzdevumu.

Inicializācija

Atveriet jebkuru direktoriju:

mkdir ralph-tui-demo && cd ralph-tui-demo ralph-tui setup Tas ievadīs interaktīvu vedņa procesu, kas būtībā ir "ralph-tui instalēšana šajā repozitorijā", tas:

• Automātiski atrod, kuri aģenti ir instalēti jūsu datorā (piemēram, Claude Code, OpenCode utt.)
• Izveido konfigurācijas failu projektā: .ralph-tui/config.toml
• Uzreiz instalē PRD ģenerēšanas/uzdevumu konvertēšanas prasmes (lai jums vēlāk nebūtu jātērē laiks manuālai konfigurēšanai)

Es personīgi iesaku: pirmajā reizē neslinkojiet, noteikti palaidiet setup.

Projekta PRD ģenerēšana

Pēc setup palaišanas nākamais solis ir oficiālajā apmācībā centrālais un piemērotākais posms, ko rakstīt kā demo emuāru: create-prd.

ralph-tui create-prd --chat šī komanda ievadīs dialoga procesu, kas uzdos jums jautājumus par prasību mērķiem, robežnosacījumiem un pieņemšanas kritērijiem, tāpat kā produktu vadītājs. Pēc jautājumu uzdošanas tas projektā tieši izveidos divas lietas (un tas ir galvenais):

• PRD markdown failu: ./tasks/prd-feature.md
• Izpildāmu uzdevumu failu: ./prd.json

Šajā solī jūs patiešām ieejat ralph-tui "standarta slēgtajā ciklā":

Prasības (PRD) → Uzdevumi (prd.json) → Izpilde (run)

Palaist

Pēc prd.json izveides, run ir loģisks solis:

ralph-tui run --prd ./prd.json jūs redzēsiet TUI saskarni, kas sāk cilpu: izvēlas uzdevumu → izpilda → nosaka pabeigšanu → raksta statusu → beidzas vai pāriet uz nākamo kārtu.

Pirmajā reizē es ļoti iesaku pievienot iterācijas ierobežojumu, vispirms ieslēdziet to būrī:

ralph-tui run --prd ./prd.json --iterations 5 pēc palaišanas pārbaudiet izmaiņas, palaidiet testus un pārbaudiet, vai PRD un uzdevumi atbilst cerībām. Pārliecinieties, vai šī ķēde ir caurlaidīga, pēc tam atlaidiet iterācijas, pēc tam izmantojiet headless/remote, tas ir uzticams ritms.

Šajā brīdī jūs varat pārliecināties, ka: šis cikls patiešām darbojas.

Kā izvēlēties modeli/aģentu? Par naudas taupīšanu jārunā godīgi

Es zinu, ka daudzi cilvēki visvairāk uztraucas par: "Vai es varu neizmantot Claude Code? Vai es varu izmantot lētākus modeļus?"

Atbilde ir: jā.

ralph-tui ļauj norādīt aģentu un modeli (oficiālajā run dokumentācijā ir piemēri).

Piemēram, izmantojot Claude Opus:

ralph-tui run --prd ./prd.json --agent claude --model opus Bet godīgi sakot, es pats neizmantotu Opus, lai veiktu tādus darbus kā "papildināt testus, labot lint", tas ir pārāk dārgi. Mans ieradums ir stratificēt:

• Lēti modeļi: veic daudz atkārtotu darbu (papildina testus, papildina komentārus, labo formātu, pievieno robežas)
• Dārgi modeļi: parādās tikai galvenajos posmos (arhitektūras pielāgošana, sarežģītas kļūdas, galvenā loģika)

Ja esat parasts izstrādātājs, šī pieeja ir vēl svarīgāka. Tā kā jums nav liela uzņēmuma budžeta, jums ir jānodrošina, lai izmaksas būtu kontrolējamas, lai jūs varētu darboties ilgāk.

Vēlaties vēl labāk? Uzticiet aģentam arī "PRD rakstīšanu"

ralph-tui ir dizains, kas man ļoti patīk: tas atbalsta skills (vienkārši sakot, tas ir aģenta papildu komandu komplekts).

Oficiālais instalēšanas veids ir izmantot add-skill:

bunx add-skill subsy/ralph-tui --all vai instalēt noteiktam aģentam, piemēram, claude-code:

bunx add-skill subsy/ralph-tui -a claude-code -g -y Pēc instalēšanas jūs varat izmantot slash komandu aģenta sesijā:

/ralph-tui-prd /ralph-tui-create-json /ralph-tui-create-beads Tas ir ļoti līdzīgi tam, ka IDE ir instalēts spraudnis, tikai šis spraudnis ir paredzēts aģentam. Tā nozīme ir samazināt "manuālas prasību pārvietošanas" laiku, padarot prasības → uzdevumus → izpildi vairāk kā ražošanas līniju.

Kad to vajadzētu izmantot? Kad nevajadzētu?Es neesmu liels piekritējs naratīvam "AI var atrisināt visu", jo tas var būt maldinošs. Rīks ir tikai rīks, un tas ir vērtīgs tikai tad, ja tas ir piemērots konkrētai situācijai.

Situācijas, kurās ralph-tui ir piemērots

Jums ir daudz šāda veida darbu:

• Testu papildināšana (īpaši veciem projektiem)
• Lint / format labošana
• Mazi refaktoringa soļi (atkārtota koda savākšana)
• Liela apjoma tipu pievienošana, robežu papildināšana
• Prasību sadalīšana un pakāpeniska virzīšana uzdevumu rindā

Šiem darbiem ir viena kopīga iezīme: daudz uzdevumu, augsta atkārtošanās pakāpe, var pieņemt, var iteratīvi virzīt uz priekšu.

Situācijas, kurās nevajadzētu spiest ralph-tui

Jums ir jāveic šādi darbi:

• Vienreizēja liela refaktorēšana, pieņemšanas kritēriji nav skaidri
• Pašas prasības ir neskaidras, paļaujoties uz jūsu slēptajām zināšanām
• Nepieciešama liela apjoma saziņa/apstiprināšana starp komandām
• Jums jāpieņem produktu lēmumi

Šādos uzdevumos aģenta cilpa tikai palielinās haosu.

Kāda ir atšķirība starp to un ralph-loop (ralph-claude-code)?

ralph-claude-code vairāk atgādina "Claude Code autopilotu": skripts to palaiž, izpilda ciklu, izejas noteikšana, plūsmas ierobežošana, ķēdes pārtraucējs nodrošina aizsardzību. Jums ir nepieciešams "ātri", un tas ir ātrs.

ralph-tui vairāk atgādina "aģenta cilpas inženierijas konsoli": tas neierobežo konkrētu modeli vai konkrētu uzdevumu sistēmu. Tas vēlas atrisināt tādus inženierijas jautājumus kā "ilgtermiņa darbība, novērojamība, kontrolējamība, atjaunojamība, attālināta vadība".

Tātad, ja jūs man jautājat, kā izvēlēties?

• Jūs esat Claude Code lietotājs un vēlaties to ātri palaist → ralph-claude-code
• Jūs vēlaties pievienot dažādus modeļus, ietaupīt naudu, vēlaties pārvaldīt cilpu kā pakalpojumu → ralph-tui

Visbeidzot: neļaujiet tam izmantot jūsu repozitoriju kā laboratoriju

Man pašam, izmantojot aģenta cilpu, ir vairāki dzelzs likumi, esmu tos uzrakstījis šeit, lai jūs tos ievērotu, un neveiksmes varbūtība būs daudz mazāka:

• Izmantojiet zaru, lai palaistu, nevis spēlējieties uz main.
• Pirmajā reizē noteikti pievienojiet --iterations, vispirms veiciet nelielu soli, lai pārliecinātos, ka tas nezaudē prātu.
• Uzdevumam jābūt pieņemamam: vai nu var palaist testus, vai nu var palaist lint, vai nu var salīdzināt izvades failus.
• Jums jāiemācās apstāties: redzot, ka tas sāk riņķot, apstādināt ir gudrāk nekā turpināt tērēt naudu.
• Lēti modeļi veic rupju darbu, dārgi modeļi veic svarīgu darbu: izmaksas tiek pārvaldītas, nevis izlūgtas. Projekta adrese: https://github.com/subsy/ralph-tui