Loksins er það hér! Ralph TUI, sjónrænt Ralph Loop

Ég skrifaði áður kennsluefni um ralph-loop, og margir vinir sögðu eftir að hafa keyrt það: Það er frábært, Claude Code getur loksins keyrt í langan tíma. En stundum þegar þú horfir á það virðist það vera kyrrt, og þú getur ekki annað en spurt sjálfan þig: "Er það í raun að vinna, eða er það bara að snúast í hringi?"

Þetta er ástæðan fyrir því að ég hef verið að fikta í ralph-tui undanfarið.

ralph-tui krefst ekki bindandi við Claude Code, það erfir og þróar kjarna ralph loop og gerir verkefnaframkvæmd og ferli sýnileg, sem dregur verulega úr þröskuldinum fyrir stórar líkön til að vinna í langan tíma. Þú getur alveg tengt önnur umboð, önnur líkön, innlend, ódýr, þau sem þú hefur efni á að keyra til lengri tíma litið. Með ralph-tui er það fyrir okkur venjulegt fólk eins og að skipta úr beinskiptingu í sjálfskiptingu með hraðastilli.

Hvað er þetta eiginlega?

Þú getur litið á ralph-tui sem "hringrásarstjórnanda fyrir AI kóðunarumboð", en það er ekki nóg að "geta keyrt", það er meira annt um "þú getur séð, stjórnað og endurheimt".

Grunnvinnsluaðferð þess er mjög einföld:

• Þú gefur því fullt af verkefnum (hvort sem það kemur frá PRD eða öðrum verkefnakerfum)
• Það velur það sem hefur hæsta forgang
• Setur saman prompt
• Ræsir umboð til að framkvæma
• Ákveður hvort þetta verkefni teljist lokið
• Skrifar stöðu
• Næsta umferð heldur áfram

Lykilatriðið er: þú getur séð allt þetta í flugstöðinni og þú getur stöðvað og tekið við hvenær sem er. Opinberlega er staðsetningin einnig skrifuð mjög beint: agent loop orchestrator með gagnvirkum TUI, og styður TUI / headless / remote.

Hvers vegna segi ég að það sé betra fyrir "langtíma keyrslu"?

Stærsta vandamálið við að keyra loop með forskrift er ekki að það keyri ekki, heldur að þú veist ekki hvar það er komið.

Þú sérð annálana fljúga hratt og viftan snýst líka ágætlega, en þú ert ekki viss:

• Er það að endurtaka sig við að laga sömu villuna?
• Er það alltaf að breyta sama kóðabútnum og breyta honum svo aftur?
• Er það búið, en hættir ekki?
• Er það fast í einhverri prófun og endurtekur sig endalaust?

Lausn ralph-tui er mjög "verkfræðileg":

• Það er hugtak um lotu, staða verður vistuð á disk (.ralph-tui/session.json)
• Hægt er að endurheimta keyrslu ef hún hrynur (crash recovery)
• Það er læsingarbúnaður til að koma í veg fyrir að þú opnir nokkur tilvik og eyðileggur möppuna
• Það er einnig hægt að keyra headless í CI, eða jafnvel opna listener á fjartengdum stað og tengjast með TUI á staðnum

Í einu orði sagt: Það er meira eins og "þú ert að stjórna verkamanni sem getur skrifað kóða", frekar en "þú ert að fylgjast með forskrift sem er að bila".

Hvernig á að setja upp

ralph-tui er Bun/TypeScript vistkerfi, svo það er frekar auðvelt að setja það upp. Opinberlega er einnig gefin uppsetningarsíða.

Gakktu úr skugga um að þú hafir bun á vélinni þinni:

bun --versionSettu síðan upp ralph-tui (ég gef hér dæmigerða uppsetningu, sjá opinberu uppsetningarsíðuna fyrir nákvæmar upplýsingar):

bun add -g ralph-tuiGakktu úr skugga um að það sé uppsett:

ralph-tui --helpEf þú ert Node aðdáandi og vilt ekki snerta bun, þá er það líka í lagi:

npm i -g ralph-tui

Ekki gera stórt í fyrstu, keyrðu lágmarks lokaða lykkju

Ég mæli með því að þegar þú notar það í fyrsta skipti, ekki gera neitt eins og "endurgera allt repo". Gerðu bara eitt: láttu það keyra í gegnum lítið verkefni sem hægt er að samþykkja.

Upphafstillun

Opnaðu hvaða möppu sem er:

mkdir ralph-tui-demo && cd ralph-tui-demo ralph-tui setupÞetta fer í gagnvirkt leiðsagnarferli, sem í raun þýðir "að setja ralph-tui upp í þessari geymslu", það mun:

• Greinir sjálfkrafa hvaða agents eru uppsettir á vélinni þinni (eins og Claude Code, OpenCode o.s.frv.)
• Býr til stillingarskrá í verkefninu: .ralph-tui/config.toml
• Setur upp skills sem tengjast PRD-gerð/verkefnabreytingum (þú þarft ekki að vesenast með það handvirkt seinna)

Mín persónulega ráðgjöf: Vertu ekki latur í fyrsta skipti, keyrðu setup alltaf.

Búa til PRD fyrir verkefni

Þegar setup er búið, er næsta skref kjarninn í opinberu kennsluefninu, og einnig það sem hentar best til að skrifa kynningu á opinberum reikningi: create-prd.

ralph-tui create-prd --chat skipunin fer í samræðuferli, þar sem hún spyr þig eins og vörustjóri um markmið, takmarkanir og viðmiðanir fyrir samþykki. Eftir að hafa spurt, mun hún skila tveimur hlutum beint í verkefninu (þetta er aðalatriðið):

• Markdown skrá með PRD: ./tasks/prd-feature.md
• Verkefnaskrá sem hægt er að keyra beint: ./prd.json

Á þessu stigi ertu í raun kominn inn í "staðlaða hringrás" ralph-tui:

Krafa (PRD) → Verkefni (prd.json) → Keyrsla (run)

Keyra það

Þegar þú ert með prd.json, er eðlilegt að keyra:

ralph-tui run --prd ./prd.json Þú munt sjá TUI ræsast og byrja að loopa: velja verkefni → framkvæma → ákvarða hvort það sé lokið → skrifa stöðu → enda eða næsta umferð.

Í fyrsta skipti sem ég keyri, mæli ég eindregið með því að bæta við endurtekningarmörkum, lokaðu því fyrst inni í búri:

ralph-tui run --prd ./prd.json --iterations 5 Eftir að keyrslu er lokið, skoðaðu breytingarnar, keyrðu prófanir, athugaðu hvort PRD og verkefni séu eins og búist var við. Staðfestu að þessi hlekkur sé í lagi, slepptu síðan endurtekningunum, farðu síðan í headless/remote, þetta er áreiðanleg taktur.

Á þessum tímapunkti geturðu í grundvallaratriðum staðfest: Þessi loop keyrir í raun.

Hvernig á að velja líkan/Agent? Heiðarleiki um peningasparnað

Ég veit að margir hafa mestar áhyggjur af því: "Get ég sleppt því að nota Claude Code? Get ég notað ódýrari líkön?"

Svarið er: Já.

ralph-tui sjálft styður þig við að tilgreina agent og model (það eru dæmi í opinberu run skjalinu).

Til dæmis, notaðu Claude Opus:

ralph-tui run --prd ./prd.json --agent claude --model opus En satt best að segja myndi ég ekki nota Opus til að vinna "bæta við prófum, laga lint" vinnu, það er of dýrt. Mín venja er að skipta því upp í lög:

• Ódýr líkön: Keyra mikið af endurtekinni vinnu (bæta við prófum, bæta við athugasemdum, laga snið, bæta við mörkum)
• Dýr líkön: Aðeins notað á mikilvægum stöðum (arkitektúrbreytingar, erfið villur, kjarna rökfræði)

Ef þú ert venjulegur þróunaraðili, er þessi hugsun enn mikilvægari. Vegna þess að þú ert ekki með stórt fyrirtækjafjárhagsáætlun, þú verður að hafa stjórn á kostnaði til að geta keyrt lengi.

Viltu hafa það enn betra? Láttu agentinn sjá um "að skrifa PRD"

ralph-tui hefur hönnun sem mér líkar: það styður skills (í grundvallaratriðum er það viðbótarskipan fyrir agent).

Opinbera uppsetningaraðferðin er með add-skill:

bunx add-skill subsy/ralph-tui --all Eða settu það upp á tilteknum agent, eins og claude-code:

bunx add-skill subsy/ralph-tui -a claude-code -g -y Eftir uppsetningu geturðu notað slash skipun í agent samtali:

/ralph-tui-prd /ralph-tui-create-json /ralph-tui-create-beads Þetta er eins og að setja upp viðbót í IDE, nema þessi viðbót er fyrir agent. Merking þess er að draga úr tíma "handvirkrar flutnings kröfu", gera kröfu → verkefni → framkvæmd líkari færibandi.

Hvenær ætti ég að nota það? Hvenær ætti ég ekki að nota það?Ég er ekki hrifinn af þeirri hugmynd að "allt sé hægt að gera með gervigreind", það er auðvelt að afvegaleiða fólk. Verkfæri eru bara verkfæri, þau eru verðmæt þegar þau henta aðstæðum.

Aðstæður þar sem ralph-tui hentar

Þú ert með fullt af svona verkefnum:

• Bæta við prófunum (sérstaklega gömul verkefni)
• Laga lint / format
• Endurhanna í litlum skrefum (sameina endurteknar línur)
• Bæta við tegundum í lotum, bæta við mörkum
• Brjóta niður kröfur og ýta þeim áfram hægt og rólega í gegnum verkefnaröð

Þessi vinna á það sameiginlegt: Mörg verkefni, mikil endurtekning, hægt að samþykkja, hægt að bæta ítrekað.

Aðstæður þar sem það er ekki sniðugt að nota ralph-tui

Þú ert að gera eitthvað af þessu:

• Stór endurhönnun í einu, óljós samþykkisviðmið
• Kröfurnar sjálfar eru óljósar, byggt á óbeinni þekkingu í hausnum á þér
• Þörf á miklum samskiptum/staðfestingu milli teyma
• Þörf á að taka vöruákvarðanir

Í svona verkefnum mun agent loop bara magna upp ringulreiðina.

Hver er munurinn á því og ralph-loop (ralph-claude-code)?

ralph-claude-code er meira eins og "sjálfstýring viðbót fyrir Claude Code": Skriftan ræsir það, keyrir lykkjuna, útgönguskynjun, hraðatakmörkun og aflrofar eru allir til staðar til að tryggja öryggi. Þú vilt "hraða", það er mjög hratt.

ralph-tui er meira eins og "verkfræðistjórnborð fyrir agent loop": Það er ekki fast við ákveðið líkan, né er það fast við ákveðið verkefnakerfi. Það vill leysa verkfræðileg vandamál eins og "langtíma keyrsla, athuganleiki, stjórnhæfni, endurheimtanleiki, fjarstýring".

Svo þú spyrð mig hvernig á að velja?

• Þú ert Claude Code notandi og vilt keyra það hratt → ralph-claude-code
• Þú vilt tengja mismunandi líkön, spara peninga, vilt stjórna lykkjunni sem þjónustu → ralph-tui

Að lokum: Ekki láta það nota geymsluna þína sem rannsóknarstofu

Ég hef nokkrar járnreglur fyrir sjálfan mig þegar ég keyri agent loop, skrifaðu þær hér og fylgdu þeim, líkurnar á að þú farir illa út minnka mikið:

• Keyrðu á grein, ekki leika þér á main.
• Í fyrsta skipti sem þú keyrir, vertu viss um að bæta við --iterations, staðfestu fyrst í litlum skrefum að það sé ekki að fara á taugum.
• Verkefnið verður að vera samþykkt: Annaðhvort er hægt að keyra prófanir, eða keyra lint, eða bera saman úttaksskrár.
• Þú verður að læra að stoppa: Það er skynsamlegra að gera hlé en að halda áfram að brenna peningum þegar þú sérð það byrja að fara í hringi.
• Ódýr líkön gera grófa vinnu, dýr líkön gera mikilvæga vinnu: Kostnaður er rekinn út, ekki beðið eftir honum í bæn.Verkefnisstaður: https://github.com/subsy/ralph-tui