మీరు అడిగినది చివరకు వచ్చింది! రాల్ఫ్ TUI, విజువలైజ్డ్ రాల్ఫ్ లూప్

నేను ఇంతకు ముందు ralph-loop గురించి ఒక ట్యుటోరియల్ రాశాను, చాలా మంది స్నేహితులు దానిని అనుసరించి, ఒకే విధమైన అభిప్రాయాన్ని వ్యక్తం చేశారు: చాలా బాగుంది, క్లాడ్ కోడ్ చివరకు ఎక్కువసేపు రన్ అవుతోంది. కానీ కొన్నిసార్లు అది కదలకుండా ఉన్నట్లు కనిపిస్తుంది, మీ మనస్సులో సందేహం కలుగుతుంది: "ఇది ముందుకు సాగుతుందా లేదా అక్కడే తిరుగుతోందా?"

అందుకే నేను ఇటీవల ralph-tuiతో ప్రయోగాలు చేస్తున్నాను.

ralph-tui క్లాడ్ కోడ్‌కు కట్టుబడి ఉండవలసిన అవసరం లేదు, ఇది రాల్ఫ్ లూప్ యొక్క సారాంశాన్ని వారసత్వంగా పొంది అభివృద్ధి చేసింది మరియు టాస్క్ ఎగ్జిక్యూషన్ మరియు ప్రాసెస్‌ను విజువలైజ్ చేస్తుంది, ఇది పెద్ద మోడల్‌లను ఎక్కువసేపు పని చేయించే థ్రెషోల్డ్‌ను బాగా తగ్గిస్తుంది. మీరు ఇతర ఏజెంట్‌లను, ఇతర మోడల్‌లను, దేశీయమైనవి, చౌకైనవి, మీరు ఎక్కువసేపు రన్ చేయగలిగే వాటిని పూర్తిగా కనెక్ట్ చేయవచ్చు. రాల్ఫ్-tuiతో, సాధారణ ప్రజలమైన మనకు, ఇది మాన్యువల్ ట్రాన్స్‌మిషన్ నుండి ఆటోమేటిక్ ట్రాన్స్‌మిషన్‌కు మారినట్లు ఉంటుంది, అది కూడా క్రూయిజ్ కంట్రోల్‌తో.

ఇది అసలు ఏమిటి?

మీరు ralph-tuiని "AI కోడింగ్ ఏజెంట్ యొక్క లూప్ ఆర్కెస్ట్రేటర్"గా అర్థం చేసుకోవచ్చు, ఇది "రన్ చేయగలగడం"తో సంతృప్తి చెందదు, ఇది "మీరు చూడగలగడం, నియంత్రించగలగడం, పునరుద్ధరించగలగడం"పై ఎక్కువ శ్రద్ధ చూపుతుంది.

దీని ప్రాథమిక పని విధానం చాలా సులభం:

• మీరు దీనికి చాలా పనులను ఇస్తారు (PRD నుండి లేదా ఇతర టాస్క్ సిస్టమ్ నుండి)
• ఇది అత్యధిక ప్రాధాన్యత కలిగినదాన్ని ఎంచుకుంటుంది
• ప్రాంప్ట్‌ను కంపైల్ చేస్తుంది
• ఏజెంట్‌ను అమలు చేయడానికి ప్రారంభిస్తుంది
• ఈ టాస్క్ పూర్తయిందో లేదో నిర్ణయిస్తుంది
• స్థితిని వ్రాస్తుంది
• తదుపరి రౌండ్ కొనసాగుతుంది

ముఖ్యమైన విషయం ఏమిటంటే: మీరు టెర్మినల్‌లో ప్రతిదీ చూడవచ్చు మరియు మీరు ఎప్పుడైనా ఆపవచ్చు మరియు టేకోవర్ చేయవచ్చు. దీని అధికారిక స్థానాన్ని కూడా చాలా స్పష్టంగా వ్రాశారు: ఇంటరాక్టివ్ TUIతో కూడిన ఏజెంట్ లూప్ ఆర్కెస్ట్రేటర్ మరియు TUI / హెడ్‌లెస్ / రిమోట్‌కు మద్దతు ఇస్తుంది.

ఇది "ఎక్కువసేపు రన్ చేయడానికి" ఎందుకు అనుకూలంగా ఉంటుందని నేను అంటున్నాను?

స్క్రిప్ట్ లూప్‌ను రన్ చేయడంలో అతి పెద్ద సమస్య ఏమిటంటే, అది రన్ చేయలేకపోవడం కాదు, అది ఎక్కడ రన్ అవుతుందో మీకు తెలియకపోవడం.

లాగ్‌లు చాలా వేగంగా రిఫ్రెష్ అవుతున్నాయని మరియు ఫ్యాన్ కూడా సంతోషంగా తిరుగుతోందని మీరు చూస్తారు, కానీ మీకు నమ్మకం లేదు:

• ఇది ఒకే బగ్‌ను పదే పదే పరిష్కరిస్తుందా?
• ఇది ఒకే కోడ్‌ను మారుస్తూ, ఆపై దానిని తిరిగి మారుస్తుందా?
• ఇది పూర్తయిందా, కానీ నిష్క్రమించలేదా?
• ఇది ఏదైనా పరీక్షలో చిక్కుకుపోయి డెడ్ లూప్‌లో ఉందా?

రాల్ఫ్-tui యొక్క పరిష్కారం చాలా "ఇంజనీరింగ్"గా ఉంది:

• సెషన్ కాన్సెప్ట్ ఉంది, స్థితి డిస్క్‌లో నిక్షిప్తం చేయబడుతుంది (.ralph-tui/session.json)
• క్రాష్ అయితే రికవరీ చేసి రన్ చేయవచ్చు (crash recovery)
• లాక్ మెకానిజం ఉంది, మీరు బహుళ సందర్భాలను తెరిచి డైరెక్టరీని గందరగోళంగా మార్చకుండా నిరోధించడానికి
• ఇది హెడ్‌లెస్‌గా CI రన్ చేయడానికి కూడా విసిరివేయబడుతుంది మరియు రిమోట్‌గా రిమోట్ ఎండ్‌లో లిజనర్‌ను కూడా తెరవవచ్చు, స్థానిక TUI కనెక్ట్ అవుతుంది

ఒక్క మాటలో చెప్పాలంటే: ఇది "మీరు కోడ్ రాయగల కార్మికుడిని చూస్తున్నట్లు" ఉంది, బదులుగా "మీరు స్క్రిప్ట్ పిచ్చిగా తిరగడం చూస్తున్నట్లు".

ఎలా ఇన్‌స్టాల్ చేయాలి

rralph-tui అనేది Bun/TypeScript ఎకోసిస్టమ్, దీన్ని ఇన్‌స్టాల్ చేయడం చాలా సులభం. అధికారికంగా ఇన్‌స్టాలేషన్ పేజీ కూడా ఇచ్చారు.

మీ మెషీన్‌లో bun ఉందని నిర్ధారించుకోండి:

bun --version ఆపై ralph-tuiని ఇన్‌స్టాల్ చేయండి (నేను ఇక్కడ ఒక సాధారణ ఇన్‌స్టాలేషన్ పద్ధతిని ఇస్తున్నాను, నిర్దిష్టంగా అధికారిక ఇన్‌స్టాలేషన్ పేజీని చూడండి):

bun add -g ralph-tui ఇన్‌స్టాల్ చేసిన తర్వాత నిర్ధారించుకోండి:

ralph-tui --help మీరు Node పార్టీ అయితే, bunని తాకకూడదనుకుంటే, అది కూడా సాధ్యమే:

npm i -g ralph-tui

పెద్ద పనులు చేయడానికి ముందు, చిన్న క్లోజ్డ్ లూప్‌ను రన్ చేయండి

మొదటిసారి ఉపయోగిస్తున్నప్పుడు, వెంటనే "మొత్తం రెపోను రీఫ్యాక్టర్ చేయడం" వంటివి చేయవద్దని నేను సిఫార్సు చేస్తున్నాను. మీరు ఒక పని చేయండి: అంగీకరించదగిన చిన్న పనిని రన్ చేయండి.

ప్రారంభించండి

ఏదైనా డైరెక్టరీని తెరవండి:

mkdir ralph-tui-demo && cd ralph-tui-demo ralph-tui setup ఇది ఇంటరాక్టివ్ విజార్డ్ ప్రాసెస్‌లోకి ప్రవేశిస్తుంది, సరళంగా చెప్పాలంటే "మీరు ఈ రిపోజిటరీలో ralph-tuiని ఇన్‌స్టాల్ చేస్తున్నారు", ఇది చేస్తుంది:

• మీ మెషీన్‌లో ఏ ఏజెంట్‌లు ఇన్‌స్టాల్ చేయబడ్డాయో స్వయంచాలకంగా గుర్తించండి (ఉదాహరణకు క్లాడ్ కోడ్, ఓపెన్‌కోడ్ మొదలైనవి)
• ప్రాజెక్ట్‌లో కాన్ఫిగరేషన్ ఫైల్‌ను రూపొందించండి: .ralph-tui/config.toml
• PRD ఉత్పత్తి/టాస్క్ మార్పిడికి సంబంధించిన నైపుణ్యాలను ఇన్‌స్టాల్ చేయండి (తర్వాత మీరు స్వయంగా చేయవలసిన అవసరం లేదు)

నా వ్యక్తిగత సలహా: మొదటిసారి సోమరితనం వద్దు, సెటప్ తప్పకుండా ఒకసారి రన్ చేయండి.

ప్రాజెక్ట్ PRDని ఉత్పత్తి చేయండి

సెటప్ రన్ అయిన తర్వాత, తదుపరి దశ అధికారిక ట్యుటోరియల్‌లోని ప్రధానమైనది, మరియు అధికారిక ఖాతా డెమోగా వ్రాయడానికి చాలా అనుకూలంగా ఉంటుంది: create-prd.

ralph-tui create-prd --chat ఈ ఆదేశం సంభాషణాత్మక ప్రక్రియలోకి ప్రవేశిస్తుంది, ఇది ఉత్పత్తి నిర్వాహకుడిలా మీ అవసరాల లక్ష్యాలు, సరిహద్దు పరిస్థితులు మరియు ఆమోద ప్రమాణాలను ప్రశ్నిస్తుంది. అడిగిన తర్వాత, ఇది ప్రాజెక్ట్‌లో నేరుగా రెండు విషయాలను ఉత్పత్తి చేస్తుంది (ఇది ముఖ్యం):

• PRD యొక్క మార్క్‌డౌన్ ఫైల్: ./tasks/prd-feature.md
• నేరుగా అమలు చేయగల టాస్క్ ఫైల్: ./prd.json

ఈ దశకు చేరుకున్న తర్వాత, మీరు నిజంగా ralph-tui యొక్క "ప్రామాణిక క్లోజ్డ్ లూప్"లోకి ప్రవేశించినట్లు:

అవసరం (PRD) → టాస్క్ (prd.json) → అమలు (run)

రన్ చేయండి

prd.json ఉన్న తర్వాత, రన్ చేయడం సహజం:

ralph-tui run --prd ./prd.json మీరు TUI పైకి రావడం చూస్తారు, లూప్ ప్రారంభమవుతుంది: టాస్క్‌ను ఎంచుకోండి → అమలు చేయండి → పూర్తయిందో లేదో నిర్ధారించండి → స్థితిని వ్రాయండి → ముగించండి లేదా తదుపరి రౌండ్.

మొదటిసారి రన్ చేస్తున్నప్పుడు, నేను పునరావృత్తుల పరిమితిని జోడించాలని గట్టిగా సిఫార్సు చేస్తున్నాను, మొదట దానిని పంజరంలో ఉంచండి:

ralph-tui run --prd ./prd.json --iterations 5 రన్ అయిన తర్వాత, మార్పులను చూడండి, పరీక్షను రన్ చేయండి, PRD మరియు టాస్క్ అంచనాలకు అనుగుణంగా ఉన్నాయో లేదో చూడండి. ఈ లింక్ ద్వారా వెళ్లడం ఖాయం చేసుకున్న తర్వాత, పునరావృత్తులను విడుదల చేయండి, ఆపై హెడ్‌లెస్/రిమోట్‌కు వెళ్లండి, ఇది నమ్మదగిన లయ.

ఈ సమయంలో మీరు ప్రాథమికంగా నిర్ధారించగలరు: ఈ లూప్ నిజంగా రన్ అవుతోంది.

మోడల్/ఏజెంట్‌ను ఎలా ఎంచుకోవాలి? డబ్బు ఆదా గురించి నిజం చెప్పాలి

చాలా మందికి ఉన్న ప్రధాన ఆందోళన ఏమిటంటే: "నేను క్లాడ్ కోడ్‌ను ఉపయోగించకుండా ఉండగలనా? నేను చౌకైన మోడల్‌ను ఉపయోగించగలనా?"

సమాధానం: అవును.

ralph-tui మిమ్మల్ని ఏజెంట్ మరియు మోడల్‌ను పేర్కొనడానికి అనుమతిస్తుంది (అధికారిక రన్ డాక్యుమెంట్‌లో ఉదాహరణలు ఉన్నాయి).

ఉదాహరణకు క్లాడ్ ఓపస్‌ను ఉపయోగించండి:

ralph-tui run --prd ./prd.json --agent claude --model opus కానీ నిజాయితీగా చెప్పాలంటే, నేను స్వయంగా "పరీక్షను పూరించడం, లింట్‌ను పరిష్కరించడం" వంటి పనుల కోసం ఓపస్‌ను ఉపయోగించను, ఇది చాలా ఖరీదైనది. నా అలవాటు ఏమిటంటే లేయర్‌లుగా విభజించడం:

• చౌక మోడల్: చాలా పునరావృతమయ్యే శ్రమను రన్ చేయండి (పరీక్షను పూరించడం, వ్యాఖ్యలను పూరించడం, ఫార్మాట్‌ను పరిష్కరించడం, సరిహద్దులను జోడించడం)
• ఖరీదైన మోడల్: కీలకమైన నోడ్‌లలో మాత్రమే కనిపిస్తుంది (ఆర్కిటెక్చర్ సర్దుబాటు, కష్టమైన బగ్, కోర్ లాజిక్)

మీరు సాధారణ డెవలపర్ అయితే, ఈ ఆలోచన మరింత ముఖ్యం. ఎందుకంటే మీరు పెద్ద ఫ్యాక్టరీ బడ్జెట్ కాదు, మీరు ఖర్చును నియంత్రించగలిగితేనే ఎక్కువసేపు రన్ చేయగలరు.

మరింత ఆనందించాలనుకుంటున్నారా? "PRD వ్రాయడం" కూడా ఏజెంట్‌కు అప్పగించండి

ralph-tuiలో నాకు నచ్చిన డిజైన్ ఉంది: ఇది నైపుణ్యాలకు మద్దతు ఇస్తుంది (సరళంగా చెప్పాలంటే ఇది ఏజెంట్ యొక్క ప్లగ్-ఇన్ ఆదేశాల సమితి).

అధికారికంగా ఇన్‌స్టాల్ చేసే పద్ధతి add-skill ఉపయోగించడం:

bunx add-skill subsy/ralph-tui --all లేదా నిర్దేశిత ఏజెంట్‌కు ఇన్‌స్టాల్ చేయండి, ఉదాహరణకు claude-code:

bunx add-skill subsy/ralph-tui -a claude-code -g -y ఇన్‌స్టాల్ చేసిన తర్వాత, మీరు ఏజెంట్ సెషన్‌లో స్లాష్ ఆదేశాన్ని ఉపయోగించవచ్చు:

/ralph-tui-prd /ralph-tui-create-json /ralph-tui-create-beads ఇది మీరు IDEలో ప్లగిన్‌ను ఇన్‌స్టాల్ చేసినట్లుగా ఉంటుంది, అయితే ఈ ప్లగిన్ ఏజెంట్ కోసం ఉద్దేశించబడింది. దీని అర్థం "మానవీయంగా అవసరాలను తరలించే" సమయాన్ని తగ్గించడం, అవసరం → టాస్క్ → అమలు ఒక ప్రవాహంలా ఉండటానికి సహాయపడుతుంది.

దీన్ని ఎప్పుడు ఉపయోగించాలి? ఎప్పుడు ఉపయోగించకూడదు?నేను "AI తో ఏదైనా చేయవచ్చు" అనే కథనాన్ని ఇష్టపడను, ఇది ప్రజలను తప్పుదారి పట్టించే అవకాశం ఉంది. సాధనం ఒక సాధనం మాత్రమే, అది సందర్భానికి తగినప్పుడు మాత్రమే విలువైనది.

ralph-tui ఉపయోగించడానికి తగిన సందర్భాలు

మీకు ఈ విధమైన పనులు చాలా ఉన్నాయి:

• పరీక్షలను పూరించడం (ముఖ్యంగా పాత ప్రాజెక్ట్‌లలో)
• lint / format ను పరిష్కరించడం
• చిన్న-దశల రీఫ్యాక్టరింగ్ (నకిలీ కోడ్‌ను తగ్గించడం)
• బ్యాచ్‌లలో రకాలను జోడించడం, సరిహద్దులను పూరించడం
• అవసరాలను విడదీసి, టాస్క్ క్యూ ద్వారా నెమ్మదిగా ముందుకు తీసుకువెళ్లడం

ఈ పనులన్నింటిలో ఒక సాధారణ అంశం ఉంది: పనులు చాలా ఉన్నాయి, పునరావృతం ఎక్కువగా ఉంటుంది, ఆమోదించవచ్చు, పునరావృతమయ్యేలా ముందుకు తీసుకువెళ్లవచ్చు.

ralph-tui ని ఉపయోగించడానికి తగిన సందర్భాలు కావు

మీరు ఈ విధమైన పనులు చేస్తున్నారు:

• ఒకేసారి పెద్ద రీఫ్యాక్టరింగ్, ఆమోద ప్రమాణాలు అస్పష్టంగా ఉన్నాయి
• అవసరాలు అస్పష్టంగా ఉన్నాయి, మీ మెదడులోని అంతర్గత జ్ఞానంపై ఆధారపడి ఉంటాయి
• చాలా క్రాస్-టీమ్ కమ్యూనికేషన్ / నిర్ధారణ అవసరం
• మీరు ఉత్పత్తి నిర్ణయాలు తీసుకోవాలి

ఈ విధమైన పనులలో, agent loop గందరగోళాన్ని మాత్రమే పెంచుతుంది.

ఇది ralph-loop (ralph-claude-code) నుండి ఎలా భిన్నంగా ఉంటుంది?

ralph-claude-code అనేది "Claude Code యొక్క ఆటోమేటిక్ డ్రైవింగ్ ప్లగ్-ఇన్" లాంటిది: స్క్రిప్ట్ దాన్ని పైకి లాగుతుంది, లూప్‌ను అమలు చేస్తుంది, నిష్క్రమణ గుర్తింపు, రేట్ పరిమితి, సర్క్యూట్ బ్రేకర్ అన్నీ మీకు మద్దతు ఇస్తాయి. మీకు "వేగం" కావాలి, అది చాలా వేగంగా ఉంటుంది.

ralph-tui అనేది "agent loop యొక్క ఇంజనీరింగ్ కన్సోల్" లాంటిది: ఇది ఒక నిర్దిష్ట నమూనాకు అతుక్కోదు లేదా ఒక నిర్దిష్ట టాస్క్ సిస్టమ్‌కు అతుక్కోదు. ఇది "దీర్ఘకాలికంగా అమలు చేయడం, పరిశీలించదగినది, నియంత్రించదగినది, పునరుద్ధరించదగినది, రిమోట్‌గా" వంటి ఇంజనీరింగ్ సమస్యలను పరిష్కరించడానికి ప్రయత్నిస్తుంది.

కాబట్టి మీరు నన్ను ఎలా ఎంచుకోమని అడుగుతారు?

• మీరు Claude Code వినియోగదారు అయితే, దాన్ని త్వరగా అమలు చేయాలనుకుంటే → ralph-claude-code
• మీరు వేర్వేరు నమూనాలను కనెక్ట్ చేయాలనుకుంటే, డబ్బు ఆదా చేయాలనుకుంటే, loop ను సర్వీస్‌గా నిర్వహించాలనుకుంటే → ralph-tui

చివరిగా: మీ రిపోజిటరీని ప్రయోగశాలగా మార్చవద్దు

నేను agent loop ను అమలు చేయడానికి కొన్ని కఠినమైన నియమాలు ఉన్నాయి, వాటిని ఇక్కడ వ్రాస్తున్నాను, మీరు వాటిని అనుసరిస్తే, ప్రమాదం జరిగే అవకాశం చాలా తక్కువగా ఉంటుంది:

• బ్రాంచ్‌లో అమలు చేయండి, main లో ప్రాణాలతో ఆడకండి.
• మొదటిసారి అమలు చేసేటప్పుడు తప్పకుండా --iterations ను జోడించండి, అది పిచ్చిగా మారదని నిర్ధారించుకోవడానికి చిన్న అడుగులు వేయండి.
• టాస్క్‌ను ఆమోదించగలగాలి: పరీక్షను అమలు చేయగలగాలి, lint ను అమలు చేయగలగాలి లేదా అవుట్‌పుట్ ఫైల్‌లను సరిపోల్చగలగాలి.
• మీరు ఆపడానికి నేర్చుకోవాలి: అది వృత్తాకారంగా తిరగడం ప్రారంభించినప్పుడు, డబ్బును కాల్చడం కంటే పాజ్ చేయడం తెలివైన పని.
• చౌక నమూనాలు కఠినమైన పనులు చేస్తాయి, ఖరీదైన నమూనాలు కీలకమైన పనులు చేస్తాయి: ఖర్చు నిర్వహణ ద్వారా వస్తుంది, ప్రార్థన ద్వారా కాదు.ప్రాజెక్ట్ చిరునామా: https://github.com/subsy/ralph-tui