În sfârșit a sosit ceea ce așteptați! Ralph TUI, vizualizarea Ralph Loop

Am scris anterior un tutorial despre ralph-loop, iar mulți prieteni, după ce l-au rulat, au oferit un feedback destul de consistent: E super, Claude Code poate rula în sfârșit pentru o perioadă lungă de timp. Dar uneori, când îl observi, pare să nu se miște deloc, și inevitabil te întrebi: "Oare avansează sau se învârte pe loc?"

Acesta este motivul pentru care m-am ocupat recent de ralph-tui.

ralph-tui nu obligă la utilizarea Claude Code, moștenește și dezvoltă esența ralph loop și vizualizează execuția sarcinilor și procesul, reducând semnificativ bariera pentru ca modelele mari să funcționeze pe termen lung. Puteți conecta complet alți agenți, alte modele, modele interne, ieftine, pe care vă puteți permite să le rulați pe termen lung. Cu ralph-tui, pentru noi, oamenii obișnuiți, semnificația este comparabilă cu trecerea de la o cutie de viteze manuală la una automată cu pilot automat.

Ce este de fapt?

Puteți înțelege ralph-tui ca pe un "orchestrator de bucle pentru agenți de codare AI", doar că nu se mulțumește cu "poate rula", ci este mai preocupat de "poți vedea, poți controla, poți recupera".

Modul său de lucru de bază este foarte simplu:

• Îi oferi o grămadă de sarcini (pot veni din PRD, pot veni din alte sisteme de sarcini)
• Alege una cu prioritatea cea mai mare
• Asamblează prompt-ul
• Lansează agentul pentru a executa
• Judecă dacă sarcina este considerată finalizată
• Scrie starea
• Următoarea rundă continuă

Punctul important este: poți vedea totul în terminal și poți opri și prelua controlul oricând. Oficial, și-au scris poziționarea foarte direct: un orchestrator de bucle de agent cu TUI interactiv și suportă TUI / headless / remote.

De ce spun că este mai potrivit pentru "rulare pe termen lung"?

Cea mai mare problemă cu rularea unui script în buclă nu este că nu poate rula, ci că nu știi unde a ajuns.

Vezi jurnalele derulând rapid, ventilatorul se învârte și el fericit, dar nu ești sigur:

• Repară același bug în mod repetat?
• Modifică aceeași secțiune de cod și apoi o modifică înapoi?
• A terminat deja, dar nu a ieșit?
• Este blocat într-un test într-o buclă infinită?

Soluția ralph-tui este foarte "inginerescă":

• Are conceptul de sesiune, starea va fi salvată pe disc (.ralph-tui/session.json)
• Dacă se blochează, poate fi reluat (crash recovery)
• Are un mecanism de blocare pentru a evita deschiderea mai multor instanțe care să distrugă directorul
• Poate fi rulat headless în CI și chiar remote, deschizând un listener la distanță, iar TUI-ul local se conectează la el

Într-un cuvânt: este mai mult ca și cum "gestionezi un muncitor care știe să scrie cod", decât "urmărești un script care se comportă ciudat".

Cum se instalează

ralph-tui este un ecosistem Bun/TypeScript, așa că instalarea este destul de simplă. Oficialii au oferit și o pagină de instalare.

Mai întâi, asigură-te că ai bun pe mașina ta:

bun --version apoi instalează ralph-tui (aici dau o metodă tipică de instalare, specificul depinde de pagina oficială de instalare):

bun add -g ralph-tui După instalare, verifică:

ralph-tui --help Dacă ești un fan Node și nu vrei să te atingi de bun, poți face și asta:

npm i -g ralph-tui

Nu te apuca de lucruri mari, rulează o buclă minimă închisă

Sugerez ca, pentru prima utilizare, să nu te apuci imediat de "refactorizarea întregului repo". Fă un singur lucru: fă-l să ruleze o sarcină mică, acceptabilă.

Inițializare

Deschide un director aleatoriu:

mkdir ralph-tui-demo && cd ralph-tui-demo ralph-tui setup Aceasta va intra în procesul de ghidare interactivă, care, în esență, înseamnă "instalarea ralph-tui în acest depozit", va:

• Detectează automat ce agenți ai instalat pe mașina ta (cum ar fi Claude Code, OpenCode etc.)
• Generează un fișier de configurare în proiect: .ralph-tui/config.toml
• Instalează automat skill-urile relevante pentru generarea PRD/conversia sarcinilor (nu va trebui să te mai chinui manual cu ele)

Recomandarea mea personală: Nu fi leneș la prima utilizare, rulează setup-ul neapărat!

Generarea PRD-ului proiectului

După ce rulezi setup-ul, următorul pas este cel mai important din tutorialul oficial și cel mai potrivit pentru a fi scris ca demo într-un cont public: create-prd.

Comanda ralph-tui create-prd --chat va intra într-un flux conversațional, în care te va interoga ca un manager de produs despre obiectivele cerințelor, condițiile limită și criteriile de acceptare. După ce te întreabă, va genera direct două lucruri în proiect (asta e important):

• Un fișier markdown PRD: ./tasks/prd-feature.md
• Un fișier de sarcini executabil direct: ./prd.json

Până în acest punct, ai intrat cu adevărat în "bucla standard" a lui ralph-tui:

Cerințe (PRD) → Sarcini (prd.json) → Execuție (run)

Rulează

Odată ce ai prd.json, rularea devine logică:

ralph-tui run --prd ./prd.json vei vedea TUI-ul pornit, începând bucla: alege sarcina → execută → verifică finalizarea → scrie starea → termină sau trece la următoarea rundă.

Când rulezi pentru prima dată, recomand cu tărie să adaugi o limită de iterații, mai întâi închide-l într-o cușcă:

ralph-tui run --prd ./prd.json --iterations 5 după ce rulează, verifică modificările, rulează teste, verifică dacă PRD-ul și sarcinile sunt conform așteptărilor. Confirmă că acest lanț este funcțional, apoi eliberează iterațiile, apoi treci la headless/remote, acesta este un ritm fiabil.

În acest moment, poți confirma practic: această buclă rulează cu adevărat.

Cum să alegi modelul/Agentul? Trebuie să vorbim sincer despre economisirea banilor

Știu că mulți oameni sunt cel mai interesați de: "Pot să nu folosesc Claude Code? Pot să folosesc modele mai ieftine?"

Răspunsul este: Da.

ralph-tui în sine acceptă specificarea agentului și a modelului (există exemple în documentația oficială run).

De exemplu, folosind Claude Opus:

ralph-tui run --prd ./prd.json --agent claude --model opus dar, sincer, eu personal nu aș folosi Opus pentru a face "completarea testelor, repararea lint-ului", este prea scump. Obiceiul meu este stratificarea:

• Modele ieftine: rulează o mulțime de muncă repetitivă (completarea testelor, completarea comentariilor, repararea formatării, adăugarea limitelor)
• Modele scumpe: apar doar în puncte cheie (ajustarea arhitecturii, bug-uri dificile, logică de bază)

Dacă ești un dezvoltator obișnuit, această abordare este și mai importantă. Pentru că nu ai un buget de companie mare, trebuie să faci costurile controlabile pentru a putea rula mult timp.

Vrei să te simți mai bine? Lasă agentul să "scrie PRD-ul"

ralph-tui are un design care îmi place foarte mult: acceptă skill-uri (practic, este un set de comenzi suplimentare pentru agent).

Modul oficial de instalare este cu add-skill:

bunx add-skill subsy/ralph-tui --all sau instalează-l pe un anumit agent, cum ar fi claude-code:

bunx add-skill subsy/ralph-tui -a claude-code -g -y după instalare, poți folosi comanda slash în sesiunea agentului:

/ralph-tui-prd /ralph-tui-create-json /ralph-tui-create-beads este ca și cum ai instala un plugin în IDE, doar că acest plugin este pentru agent. Semnificația sa este de a reduce timpul de "mutare manuală a cerințelor", făcând cerințele → sarcini → execuție mai mult ca o linie de asamblare.

Când ar trebui să-l folosești? Când nu ar trebui să-l folosești?Nu-mi place prea mult narațiunea de genul "orice poate fi rezolvat cu AI", este ușor să inducă în eroare. Un instrument este doar un instrument, valoros doar în scenariul potrivit.

Scenarii potrivite pentru utilizarea ralph-tui

Ai o grămadă de sarcini de genul:

• Completarea testelor (în special proiecte vechi)
• Repararea lint / formatare
• Refactorizare în pași mici (convergența codului duplicat)
• Adăugarea de tipuri în masă, completarea limitelor
• Descompunerea cerințelor și împingerea lentă în funcție de coada de sarcini

Aceste sarcini au un punct comun: multe sarcini, grad ridicat de repetare, pot fi acceptate, pot fi avansate iterativ.

Scenarii în care nu este potrivit să forțezi ralph-tui

Ceea ce vrei să faci este:

• Refactorizare majoră o singură dată, standarde de acceptare neclare
• Cerințe neclare în sine, bazate pe cunoștințele tale implicite
• Necesită o mulțime de comunicare/confirmare între echipe
• Trebuie să faci judecăți de produs

Pentru astfel de sarcini, agent loop nu va face decât să amplifice confuzia.

Care este diferența dintre acesta și ralph-loop (ralph-claude-code)?

ralph-claude-code este mai mult ca un "plugin de conducere autonomă pentru Claude Code": scriptul îl pornește, rulează bucla, detectarea ieșirii, limitarea ratei, întrerupătorul sunt toate asigurate. Vrei "rapid", și este foarte rapid.

ralph-tui este mai mult ca o "consolă de control de inginerie pentru agent loop": nu sudează un anumit model și nici un anumit sistem de sarcini. Ceea ce încearcă să rezolve sunt problemele de inginerie "rulare pe termen lung, observabilitate, controlabilitate, recuperabilitate, accesibilitate de la distanță".

Deci, mă întrebi cum să aleg?

• Ești utilizator Claude Code și vrei să-l rulezi rapid → ralph-claude-code
• Vrei să conectezi diferite modele, vrei să economisești bani, vrei să gestionezi bucla ca un serviciu → ralph-tui

În cele din urmă: nu lăsați depozitul dvs. să devină un laborator

Am câteva reguli de aur pentru rularea agent loop, le scriu aici, fă-le și tu, probabilitatea de eșec va fi mult mai mică:

• Rulează pe ramură, nu te juca pe main.
• Prima rulare trebuie să adauge --iterations, confirmă mai întâi în pași mici că nu va înnebuni.
• Sarcina trebuie să fie acceptabilă: fie poate rula teste, fie poate rula lint, fie poate compara fișierele de ieșire.
• Trebuie să înveți să te oprești: este mai inteligent să te oprești decât să continui să arzi bani când vezi că începe să se învârtă în cerc.
• Modelele ieftine fac munca grea, modelele scumpe fac munca critică: costul este operat, nu este obținut prin rugăciune.Adresa proiectului: https://github.com/subsy/ralph-tui