Më në fund erdhi ajo që po prisnit! Ralph TUI, Ralph Loop vizual

Kam shkruar më parë një tutorial rreth ralph-loop, dhe shumë miq kanë dhënë reagime të ngjashme pasi e kanë provuar: Është super, Claude Code më në fund mund të funksionojë për një kohë të gjatë. Por ndonjëherë e vëreni se duket sikur nuk lëviz fare, dhe nuk mund të mos pyesni veten: "A po ecën përpara, apo po rrotullohet në vend?"

Kjo është arsyeja pse kam qenë duke u marrë me ralph-tui kohët e fundit.

ralph-tui nuk e detyron lidhjen me Claude Code, por trashëgon dhe zhvillon thelbin e ralph loop, dhe e vizualizon ekzekutimin e detyrave dhe procesin, duke ulur ndjeshëm pragun për modelet e mëdha që të punojnë për një kohë të gjatë. Ju mund të lidhni plotësisht agjentë të tjerë, modele të tjera, modele vendase, të lira, që mund t'i mbani duke funksionuar për një kohë të gjatë. Me ralph-tui, për ne njerëzit e zakonshëm, kjo është po aq e rëndësishme sa kalimi nga një makinë manuale në një automatike me kontroll lundrimi.

Çfarë është në të vërtetë?

Ju mund ta kuptoni ralph-tui si një "organizator ciklik i agjentëve të kodimit AI", por nuk është i kënaqur vetëm me "mund të funksionojë", por i intereson më shumë "mund ta shihni, mund ta kontrolloni, mund ta riktheni".

Mënyra e tij themelore e punës është shumë e thjeshtë:

• Ju i jepni një sërë detyrash (mund të vijnë nga PRD, ose nga sisteme të tjera detyrash)
• Ai zgjedh atë me prioritetin më të lartë
• Ndërton prompt
• Nis agjentin për ta ekzekutuar
• Gjykon nëse kjo detyrë konsiderohet e përfunduar
• Shkruan statusin
• Vazhdon me raundin tjetër

Pika kryesore është: ju mund ta shihni gjithë këtë në terminal, dhe mund ta ndaloni dhe ta merrni përsipër në çdo kohë. Zyrtarisht, pozicionimi i tij është shkruar shumë qartë: një orchestrator i agent loop me TUI interaktiv, dhe mbështet TUI / headless / remote.

Pse them se është më i përshtatshëm për "funksionim afatgjatë"?

Problemi më i madh me skriptet që funksionojnë në loop nuk është se nuk mund të funksionojnë, por se nuk e dini se ku kanë arritur.

Ju shihni që log-et shfaqen me shpejtësi, dhe ventilatori po rrotullohet me kënaqësi, por nuk jeni i sigurt:

• A po e rregullon të njëjtin bug vazhdimisht?
• A po e ndryshon të njëjtin kod vazhdimisht dhe pastaj e kthen përsëri?
• A ka përfunduar tashmë, por nuk ka dalë?
• A është bllokuar në një test dhe po rrotullohet pafundësisht?

Zgjidhja e ralph-tui është shumë "inxhinierike":

• Ka një koncept sesioni, dhe statusi do të ruhet në disk (.ralph-tui/session.json)
• Mund të rifillojë pas një avarie (crash recovery)
• Ka një mekanizëm bllokimi për të shmangur hapjen e shumë instancave dhe shkatërrimin e direktorisë
• Mund të hidhet edhe në CI në mënyrë headless, madje edhe remote të hapë një listener në anën e largët, dhe TUI lokale të lidhet atje

Me një fjali: Është më shumë sikur "po menaxhoni një punëtor që di të shkruajë kod", sesa "po shikoni një skript që po çmendet".

Si të instaloni

ralph-tui është një ekosistem Bun/TypeScript, kështu që instalimi është mjaft i lehtë. Zyrtarisht, ata kanë dhënë një faqe instalimi.

Së pari, sigurohuni që keni bun në makinën tuaj:

bun --version pastaj instaloni ralph-tui (këtu po jap një mënyrë tipike instalimi, specifikisht referojuni faqes zyrtare të instalimit):

bun add -g ralph-tui Pasi të keni mbaruar, konfirmoni:

ralph-tui --help Nëse jeni një Node party dhe nuk doni të prekni bun, mundeni gjithashtu:

npm i -g ralph-tui

Mos u merrni me gjëra të mëdha menjëherë, ekzekutoni një loop minimal

Unë sugjeroj që herën e parë që e përdorni, mos u merrni me diçka si "ristrukturimi i të gjithë repo". Bëni vetëm një gjë: Sigurohuni që të ekzekutoni një detyrë të vogël të pranueshme.

Inicializimi

Hapni një direktori kudo:

mkdir ralph-tui-demo && cd ralph-tui-demo ralph-tui setup Kjo do të hyjë në procesin e udhëzuesit interaktiv, që në thelb do të thotë "instaloni ralph-tui në këtë depo", ai do të:

• Zbulon automatikisht cilët agjentë janë instaluar në makinën tuaj (si p.sh. Claude Code, OpenCode, etj.)
• Gjeneron një skedar konfigurimi në projekt: .ralph-tui/config.toml
• Instalon me lehtësi aftësitë e lidhura me gjenerimin e PRD/konvertimin e detyrave (nuk do të keni nevojë të lodheni vetë më vonë)

Unë personalisht sugjeroj: Mos u tregoni dembel në fillim, setup duhet të ekzekutohet patjetër një herë.

Gjenerimi i PRD-së së projektit

Pasi të ketë përfunduar setup, hapi tjetër është thelbi i udhëzuesit zyrtar, dhe gjithashtu më i përshtatshmi për t'u shkruar si një demo në llogarinë publike: create-prd.

ralph-tui create-prd --chat kjo komandë do të hyjë në një proces bisedor, do t'ju pyesë për qëllimet e kërkesave, kushtet kufitare dhe standardet e pranimit si një menaxher produkti. Pasi të ketë mbaruar së pyeturi, do të nxjerrë drejtpërdrejt dy gjëra në projekt (ky është thelbi):

• Një skedar markdown i PRD-së: ./tasks/prd-feature.md
• Një skedar detyrash i ekzekutueshëm drejtpërdrejt: ./prd.json

Në këtë hap, ju keni hyrë vërtet në "ciklin standard të mbyllur" të ralph-tui:

Kërkesa (PRD) → Detyra (prd.json) → Ekzekutimi (run)

Ekzekutimi (run)

Me prd.json, ekzekutimi (run) bëhet i natyrshëm:

ralph-tui run --prd ./prd.json do të shihni TUI të ngrihet dhe të fillojë loop: zgjedh detyrën → ekzekuton → gjykon përfundimin → shkruan statusin → përfundon ose kalon në raundin tjetër.

Për herë të parë, unë rekomandoj fuqimisht të shtoni një kufi përsëritjeje, fillimisht mbylleni në një kafaz:

ralph-tui run --prd ./prd.json --iterations 5 pasi të ketë përfunduar, shikoni ndryshimet, ekzekutoni testet, shikoni nëse PRD dhe detyrat janë në përputhje me pritjet. Konfirmoni që kjo lidhje është e hapur, pastaj lëshoni përsëritjet, pastaj kaloni në headless/remote, ky është ritmi i besueshëm.

Në këtë kohë, ju mund të konfirmoni në thelb: Ky loop po ekzekutohet vërtet.

Si të zgjidhni modelin/agjentin? Duhet të flasim sinqerisht për kursimin e parave

E di që shumë njerëz janë më të shqetësuar për: "A mund të mos përdor Claude Code? A mund të përdor modele më të lira?"

Përgjigja është: Po.

ralph-tui vetë ju lejon të specifikoni agjentin dhe modelin (ka shembuj në dokumentin zyrtar të ekzekutimit).

Për shembull, duke përdorur Claude Opus:

ralph-tui run --prd ./prd.json --agent claude --model opus por sinqerisht, unë vetë nuk do të përdorja Opus për të bërë punë si "plotësimi i testeve, rregullimi i lint", është shumë e shtrenjtë. Zakoni im është shtresimi:

• Modele të lira: Ekzekutoni shumë punë të përsëritura (plotësimi i testeve, plotësimi i komenteve, rregullimi i formatit, shtimi i kufijve)
• Modele të shtrenjta: Shfaqen vetëm në nyje kritike (rregullimi i arkitekturës, gabime të vështira, logjikë thelbësore)

Nëse jeni një zhvillues i zakonshëm, kjo mënyrë të menduari është edhe më e rëndësishme. Sepse ju nuk jeni një buxhet i madh kompanie, ju duhet ta mbani koston nën kontroll në mënyrë që të mund të ekzekutoni për një kohë të gjatë.

Doni të jetë edhe më e këndshme? Dorëzoni edhe "shkrimin e PRD" te agjenti

ralph-tui ka një dizajn që më pëlqen shumë: ai mbështet skills (në thelb është një komandë shtesë për agjentin).

Mënyra zyrtare e instalimit është duke përdorur add-skill:

bunx add-skill subsy/ralph-tui --all ose instaloni në një agjent të caktuar, si p.sh. claude-code:

bunx add-skill subsy/ralph-tui -a claude-code -g -y pasi të keni përfunduar instalimin, mund të përdorni komandën slash në sesionin e agjentit:

/ralph-tui-prd /ralph-tui-create-json /ralph-tui-create-beads Kjo është shumë si instalimi i një shtojce në IDE, vetëm se kjo shtojcë është për agjentin. Rëndësia e tij është të zvogëlojë kohën e "transportit manual të kërkesave", duke e bërë kërkesën → detyrën → ekzekutimin më shumë si një linjë montimi.

Kur duhet ta përdorni? Kur nuk duhet ta përdorni?Nuk më pëlqen shumë narracioni "gjithçka mund të bëhet me AI", është e lehtë të keqkuptohet. Mjeti është thjesht një mjet, i vlefshëm vetëm nëse përshtatet me skenarin.

Skenarët e përshtatshëm për përdorimin e ralph-tui

Ju keni një sërë punësh të tilla:

• Plotësimi i testeve (sidomos për projektet e vjetra)
• Rregullimi i lint / format
• Ristrukturim i vogël (konvergjimi i kodit të përsëritur)
• Shtimi i llojeve në grup, plotësimi i kufijve
• Shpërbërja e kërkesave dhe shtyrja e tyre gradualisht sipas radhës së detyrave

Këto punë kanë një gjë të përbashkët: shumë detyra, shkallë e lartë përsëritjeje, mund të pranohen, mund të promovohen në mënyrë iterative.

Skenarët ku nuk është e përshtatshme të përdoret me forcë ralph-tui

Ju po bëni këtë:

• Ristrukturim i madh një herë, standardet e pranimit nuk janë të qarta
• Vetë kërkesat janë të paqarta, duke u mbështetur në njohuritë e nënkuptuara në mendjen tuaj
• Kërkohet shumë komunikim/konfirmim ndër-ekipor
• Kërkohet që ju të bëni gjykime produkti

Për këto detyra, agent loop vetëm sa do të zmadhojë konfuzionin.

Cili është ndryshimi midis tij dhe ralph-loop (ralph-claude-code)?

ralph-claude-code është më shumë si një "shtojcë automatike e drejtimit për Claude Code": skripti e ngre atë, ekzekuton ciklin, detektimi i daljes, kufizimi i shpejtësisë, ndërprerësi i qarkut ju mbulojnë. Ju doni "shpejtësi", dhe ai është shumë i shpejtë.

ralph-tui është më shumë si një "konsolë inxhinierike e agent loop": nuk e lidh fort një model të caktuar, as një sistem detyrash të caktuar. Ajo që përpiqet të zgjidhë janë problemet inxhinierike si "ekzekutim afatgjatë, i vëzhgueshëm, i kontrollueshëm, i rikuperueshëm, i largët".

Pra, më pyesni se si të zgjedh?

• Ju jeni përdorues i Claude Code dhe dëshironi ta ekzekutoni shpejt → ralph-claude-code
• Ju dëshironi të lidhni modele të ndryshme, të kurseni para, të menaxhoni loop si një shërbim → ralph-tui

Së fundi: Mos e lini atë ta trajtojë depon tuaj si një laborator

Unë vetë kam disa rregulla të hekurta për ekzekutimin e agent loop, i shkruaj këtu dhe ju i ndiqni, gjasat për dështim do të jenë shumë më të vogla:

• Ekzekutoni në degë, mos luani me jetën në main.
• Kur ekzekutoni për herë të parë, shtoni patjetër --iterations, konfirmoni në hapa të vegjël që ai nuk do të çmendet.
• Detyra duhet të jetë e pranueshme: ose mund të ekzekutojë teste, ose mund të ekzekutojë lint, ose mund të krahasojë skedarët e daljes.
• Ju duhet të mësoni të ndaloni: kur shihni që ai fillon të sillet rreth e rrotull, ndalimi është më i zgjuar se sa të vazhdoni të digjni para.
• Modelet e lira bëjnë punë të rënda, modelet e shtrenjta bëjnë punë thelbësore: kostoja operohet, nuk lutet për të.Adresa e projektit: https://github.com/subsy/ralph-tui