Tässä se vihdoin on! Ralph TUI, Ralph Loopin visualisointi

Kirjoitin aiemmin ralph-loop-oppaan, ja monet ystävät, jotka kokeilivat sitä, antoivat samansuuntaista palautetta: Mahtavaa, Claude Code voi vihdoin pyöriä pitkiä aikoja. Mutta joskus kun tarkkailet sitä, se näyttää olevan liikkumatta, ja mieleen hiipii epäilys: "Eteneekö se todella, vai pyöriikö se vain paikallaan?"

Tämä on syy, miksi olen viime aikoina puuhastellut ralph-tui:n kanssa.

ralph-tui ei pakota käyttämään Claude Codea, vaan se perii ja kehittää ralph loopin ytimen ja visualisoi tehtävien suorittamisen ja prosessin, mikä alentaa huomattavasti kynnystä suurten mallien pitkäaikaiseen käyttöön. Voit täysin hyvin käyttää muita agentteja, muita malleja, kotimaisia, edullisia, sellaisia, joita sinulla on varaa pyörittää pitkään. Ralph-tui:n myötä tavallisille ihmisille merkitys on sama kuin manuaalivaihteisesta autosta automaattivaihteiseen siirtyminen vakionopeudensäätimellä.

Mikä se oikein on?

Voit ajatella ralph-tui:n "AI-koodausagentin silmukkaorkestroijana", mutta se ei tyydy vain "kykenevään pyörimään", vaan se on enemmän kiinnostunut siitä, että "näet, voit hallita ja voit palauttaa".

Sen perustoimintatapa on hyvin yksinkertainen:

• Annat sille kasan tehtäviä (voi tulla PRD:stä tai muusta tehtäväjärjestelmästä)
• Se valitsee niistä korkeimman prioriteetin omaavan
• Muodostaa promptin
• Käynnistää agentin suorittamaan sen
• Arvioi, onko tehtävä suoritettu
• Kirjoittaa tilan
• Jatkaa seuraavalle kierrokselle

Pääasia on: voit nähdä kaiken tämän terminaalissa, ja voit pysäyttää ja ottaa haltuun milloin tahansa. Sen virallinenkin määrittely on hyvin suoraviivainen: interaktiivinen TUI:lla varustettu agent loop orchestrator, joka tukee myös TUI / headless / remote -tiloja.

Miksi sanon, että se sopii paremmin "pitkäaikaiseen pyörittämiseen"?

Skriptin pyörittäminen loopissa ei ole ongelma, vaan se, että et tiedä, missä se menee.

Näet lokien vierivän nopeasti ja tuulettimen pyörivän iloisesti, mutta et ole varma:

• Korjaako se samaa bugia uudestaan ja uudestaan?
• Muuttaako se samaa koodinpätkää jatkuvasti edestakaisin?
• Onko se jo valmis, mutta ei vain lopeta?
• Onko se jumissa jossain testissä ja pyörii loputtomasti?

ralph-tui:n ratkaisu on hyvin "insinöörimäinen":

• Siinä on istuntokonsepti, ja tila tallennetaan levylle (.ralph-tui/session.json)
• Se voidaan palauttaa juoksemaan kaatumisen jälkeen (crash recovery)
• Siinä on lukitusmekanismi, jotta et sotke hakemistoa puuroksi avaamalla useita instansseja
• Se voidaan jopa heittää headless-tilassa CI:hin tai jopa avata remote-kuuntelija etänä ja yhdistää siihen paikallisella TUI:lla

Yhdellä lauseella: Se on enemmän kuin "valvoisit koodaavaa työntekijää" kuin "tuijottaisit skriptin sekoilua".

Kuinka asentaa

ralph-tui on Bun/TypeScript-ekosysteemiä, joten sen asentaminen on melko sujuvaa. Virallinen asennussivu on myös annettu.

Varmista ensin, että koneellasi on bun:

bun --versionAsenna sitten ralph-tui (tässä tyypillinen asennustapa, katso tarkemmat tiedot viralliselta asennussivulta):

bun add -g ralph-tuiVarmista asennuksen jälkeen:

ralph-tui --helpJos olet Node-fani etkä halua koskea buniin, sekin onnistuu:

npm i -g ralph-tui

Älä tee heti suuria asioita, pyöritä pienin mahdollinen suljettu silmukka

Suosittelen, että ensimmäisellä käyttökerralla et heti ala tekemään mitään "koko repoon uudelleenrakentamista". Tee vain yksi asia: saa se pyörittämään pienen, hyväksyttävän tehtävän.

Alustus

Avaa mikä tahansa hakemisto:

mkdir ralph-tui-demo && cd ralph-tui-demo ralph-tui setupTämä siirtyy interaktiiviseen ohjattuun prosessiin, joka yksinkertaisesti sanottuna on "ralph-tui:n asentaminen tähän arkistoon", se tekee:

• Tunnistaa automaattisesti, mitkä agentit olet asentanut koneellesi (kuten Claude Code, OpenCode jne.)
• Luo projektin sisään konfiguraatiotiedoston: .ralph-tui/config.toml
• Asentaa samalla PRD:n luontiin/tehtävien muuntamiseen liittyvät skillsit (joten sinun ei tarvitse säätää niitä manuaalisesti myöhemmin)

Henkilökohtainen suositukseni: Älä ole laiska ensimmäisellä kerralla, setup pitää ajaa läpi.

Projektin PRD:n luominen

Kun setup on ajettu, seuraava vaihe on virallisen opetusohjelman ydin, joka sopii erinomaisesti esittelyyn julkisessa kanavassa: create-prd.

ralph-tui create-prd --chat -komento käynnistää vuorovaikutteisen prosessin, joka kyselee sinulta vaatimuksista, tavoitteista, reunaehdoista ja hyväksymiskriteereistä kuin tuotepäällikkö. Kysymysten jälkeen se tuottaa suoraan kaksi asiaa projektiin (tämä on pääasia):

• PRD:n markdown-tiedoston: ./tasks/prd-feature.md
• Suoraan suoritettavan tehtävätiedoston: ./prd.json

Tässä vaiheessa olet todella astunut ralph-tui:n "standardisuljettuun silmukkaan":

Vaatimus (PRD) → Tehtävä (prd.json) → Suoritus (run)

Käynnistäminen (run)

Kun sinulla on prd.json, run on luonnollinen jatko:

ralph-tui run --prd ./prd.json Näet TUI:n käynnistyvän ja aloittavan silmukan: valitsee tehtävän → suorittaa → arvioi valmiiksi → kirjoittaa tilan → lopettaa tai siirtyy seuraavaan kierrokseen.

Ensimmäisellä kerralla suosittelen vahvasti lisäämään iteraatiorajaa, jotta se pysyy hallinnassa:

ralph-tui run --prd ./prd.json --iterations 5 Kun se on valmis, tarkastele muutoksia, aja testejä ja varmista, että PRD ja tehtävät vastaavat odotuksia. Varmista, että tämä ketju toimii, ennen kuin vapautat iteraatiot, siirryt headless/remote-tilaan. Tämä on luotettava tapa.

Tässä vaiheessa voit periaatteessa vahvistaa: Tämä silmukka todella toimii.

Miten malli/agentti valitaan? Säästämisestä on puhuttava rehellisesti

Tiedän, että monia kiinnostaa eniten: "Voinko olla käyttämättä Claude Codea? Voinko käyttää halvempia malleja?"

Vastaus on: Kyllä.

ralph-tui itsessään tukee agentin ja mallin määrittämistä (virallisessa run-dokumentaatiossa on esimerkkejä).

Esimerkiksi Claude Opus:

ralph-tui run --prd ./prd.json --agent claude --model opus Mutta rehellisesti sanottuna en itse käyttäisi Opusta "testien täydentämiseen, lint-virheiden korjaamiseen", se on liian kallista. Tapani on kerrostaa:

• Halvat mallit: Suorittavat paljon toistuvaa työtä (testien täydentäminen, kommenttien täydentäminen, muotoilun korjaaminen, rajojen lisääminen)
• Kalliit mallit: Ovat mukana vain kriittisissä kohdissa (arkkitehtuurin säätö, vaikeat bugit, ydintoiminnot)

Jos olet tavallinen kehittäjä, tämä ajattelutapa on vielä tärkeämpi. Koska sinulla ei ole suuryrityksen budjettia, sinun on pidettävä kustannukset hallinnassa, jotta voit jatkaa pitkään.

Haluatko vieläkin paremman kokemuksen? Anna agentin hoitaa myös "PRD:n kirjoittaminen"

ralph-tui:ssa on minusta hieno ominaisuus: se tukee skillsejä (pohjimmiltaan agentin lisäkomentoja).

Virallinen asennustapa on add-skill:

bunx add-skill subsy/ralph-tui --all Tai asenna tiettyyn agenttiin, kuten claude-code:

bunx add-skill subsy/ralph-tui -a claude-code -g -y Asennuksen jälkeen voit käyttää slash-komentoja agentin istunnossa:

/ralph-tui-prd /ralph-tui-create-json /ralph-tui-create-beads Tämä on kuin olisit asentanut lisäosan IDE:hen, paitsi että tämä lisäosa on tarkoitettu agentille. Sen merkitys on vähentää "ihmisen suorittaman vaatimusten siirtämisen" aikaa, jotta vaatimus → tehtävä → suoritus muistuttaa enemmän tuotantolinjaa.

Milloin sitä kannattaa käyttää? Milloin ei?

En pidä siitä narratiivista, että "kaikki voidaan hoitaa tekoälyllä", koska se on harhaanjohtava. Työkalu on vain työkalu, ja se on arvokas vain oikeassa tilanteessa.

Tilanteet, joissa ralph-tui on hyödyllinen

Sinulla on paljon tällaista työtä:

• Testien täydentäminen (erityisesti vanhoissa projekteissa)
• Lint/format-virheiden korjaaminen
• Pienet refaktoroinnit (toistuvan koodin yhdistäminen)
• Tyypitysten ja rajojen lisääminen joukkona
• Vaatimusten purkaminen ja tehtäväjonon hidas läpivienti

Näille töille on yhteistä: Paljon tehtäviä, korkea toistuvuus, hyväksyttävyys, iteratiivinen eteneminen.

Tilanteet, joissa ralph-tui ei ole hyvä valinta

Teet tällaista:

• Kertaluonteinen suuri refaktorointi, epäselvät hyväksyntäkriteerit
• Vaatimukset itsessään ovat epämääräisiä, ja ne perustuvat hiljaiseen tietoon päässäsi
• Vaatii paljon tiimienvälistä kommunikaatiota/vahvistusta
• Vaatii sinulta tuotepäätöksiä

Tällaisissa tehtävissä agent loop vain pahentaa kaaosta.

Mitä eroa sillä on ralph-loopiin (ralph-claude-code)?

ralph-claude-code on enemmän kuin "Claude Coden automaattiohjaus": skripti käynnistää sen, ajaa silmukan, ja poistumisen tunnistus, kuristus ja katkaisijat ovat kaikki katettu. Haluat "nopeutta", ja se on nopea.

ralph-tui on enemmän kuin "agent loopin tekninen konsoli": se ei ole sidottu tiettyyn malliin tai tehtäväjärjestelmään. Se pyrkii ratkaisemaan teknisiä ongelmia, kuten "pitkäaikainen ajo, havaittavuus, hallittavuus, palautettavuus ja etäkäyttö".

Joten kysyt, miten valita?

• Olet Claude Coden käyttäjä ja haluat saada sen nopeasti käyntiin → ralph-claude-code
• Haluat yhdistää erilaisia malleja, säästää rahaa ja hallita loopia palveluna → ralph-tui

Lopuksi: Älä anna sen käyttää varastoasi laboratoriona

Minulla on muutama rautainen sääntö agent loopin ajamiseen, kirjoitan ne tähän, jotta voit noudattaa niitä ja vähentää epäonnistumisen todennäköisyyttä:

• Aja haarassa, älä leiki mainissa.
• Lisää ensimmäisellä ajokerralla ehdottomasti --iterations, jotta voit pienin askelin varmistaa, ettei se sekoa.
• Tehtävien on oltava hyväksyttävissä: joko testit on ajettavissa, lint on ajettavissa tai tulostiedostoja voidaan verrata.
• Sinun on opittava pysähtymään: on viisaampaa keskeyttää kuin jatkaa rahan polttamista, kun näet sen alkavan pyöriä kehää.
• Halvat mallit tekevät karkeaa työtä, kalliit mallit tekevät kriittistä työtä: kustannukset syntyvät operoinnista, eivät rukouksista.Projektin osoite: https://github.com/subsy/ralph-tui