एआई एजेंटों के लिए गिट वर्कट्रीज़: क्लाउड कोड और कोडेक्स को समानांतर में चलाएं

गिट वर्कट्री एक ही रिपॉजिटरी से जुड़ा एक अतिरिक्त कार्यशील फ़ोल्डर है: इसकी अपनी चेक-आउट शाखा, अपना स्वयं का स्टेजिंग क्षेत्र और अपनी फ़ाइलें हैं, जबकि सभी वर्कट्री समान कमिट, शाखाएं और रिमोट साझा करते हैं। यह क्लाउड कोड या कोडेक्स जैसे एआई कोडिंग एजेंटों को समानांतर में चलाने का सबसे सरल तरीका git worktree बनाता है। प्रत्येक एजेंट को अपना स्वयं का वर्कट्री दें और वे एक-दूसरे की फ़ाइलों को छुए बिना, और दूसरे क्लोन के बिना एक ही समय में संपादित, निर्माण, परीक्षण और प्रतिबद्ध कर सकते हैं।

एक फ़ोल्डर में दो एजेंट एक कार्यशील ट्री साझा करते हैं: एक फ़ाइलों के विरुद्ध परीक्षण चलाता है, दूसरा पुनर्लेखन के आधे रास्ते में होता है, और एक git checkout या तो दूसरे के नीचे जमीन खिसका देता है। अलग-अलग क्लोन इससे बचते हैं लेकिन उन्हें अपने स्वयं के भ्रूण की आवश्यकता होती है; वर्कट्रीज़ आपको एक रिपॉजिटरी के बहीखाता के साथ अलग फ़ोल्डर देता है।

गिट वर्कट्री क्या है और वर्कट्री क्या साझा करती है

प्रत्येक रिपॉजिटरी एक वर्कट्री से शुरू होती है, मुख्य वर्कट्री: वह फ़ोल्डर जिसे git clone या git init ने बनाया है। git worktree add लिंक्ड वर्कट्रीज़ बनाता है, उसी .git डेटा से जुड़े अतिरिक्त फ़ोल्डर्स। आधिकारिक गिट वर्कट्री दस्तावेज़ीकरण के अनुसार, एक लिंक किया गया वर्कट्री प्रति-वर्कट्री फ़ाइलों जैसे कि HEAD और इंडेक्स को छोड़कर रिपॉजिटरी के साथ सब कुछ साझा करता है। व्यवहार में:

एजेंटों के लिए एक नियम मायने रखता है: डिफ़ॉल्ट रूप से, git worktree add उस शाखा की जांच करने से इंकार कर देता है जो पहले से ही किसी अन्य वर्कट्री में चेक आउट हो चुकी है। इसलिए प्रत्येक एजेंट को अपनी शाखा की आवश्यकता होती है, जो समीक्षा के समय आप बिल्कुल वही चाहते हैं।

गिट वर्कट्री ऐड के साथ वर्कट्री कैसे बनाएं

अपने रिपॉजिटरी के अंदर से कमांड चलाएँ, और इसके अंदर के बजाय इसके बगल में नए वर्कट्रीज़ रखें, ताकि संपादक, खोज उपकरण और एजेंट एक चेकआउट को दूसरे के अंदर से अनुक्रमित न करें। यह दो वर्कट्री बनाता है, प्रत्येक एक नई शाखा पर जो main से शुरू होती है:

cd ~/code/myapp
git worktree add -b agent/auth-refactor ../myapp-auth main
git worktree add -b agent/flaky-tests ../myapp-tests main
git worktree list

-b शाखा बनाता है, पथ नया फ़ोल्डर है, और अंतिम तर्क शुरू करने के लिए प्रतिबद्धता है। git worktree list प्रत्येक वर्कट्री को उसके फ़ोल्डर, कमिट और शाखा के साथ प्रिंट करता है। पहले से मौजूद शाखा का उपयोग करने के लिए, -b: git worktree add ../myapp-review feature/login को छोड़ दें।

प्रति वर्कट्री एक एआई एजेंट: समानांतर वर्कफ़्लो

पैटर्न सरल है: एक कार्य, एक शाखा, एक कार्यवृक्ष, एक एजेंट सत्र। आप समीक्षक के रूप में मुख्य वर्कट्री में रहते हैं, और एजेंट कभी भी कोई फ़ोल्डर साझा नहीं करते हैं। सबसे महत्वपूर्ण बात यह है कि आप काम का बंटवारा कैसे करते हैं। अच्छे समानांतर कार्य हैं:

• कोड के विभिन्न हिस्सों में, जैसे कि auth/ में एक रिफैक्टर और billing/ में नए परीक्षण, इसलिए उनकी शाखाएं शायद ही कभी एक ही रेखा को छूती हैं।
• स्पष्ट रूप से किया गया या नहीं किया गया: एक असफल परीक्षण जिसे उत्तीर्ण होना चाहिए, जोड़ने के लिए एक समापन बिंदु, अपग्रेड करने के लिए एक निर्भरता।
• एक बैठक में समीक्षा करने के लिए पर्याप्त छोटा। एक विशाल एजेंट अंतर एक समीक्षा समस्या है, चाहे वह किसी भी फ़ोल्डर से आया हो।

cd ../myapp-auth && claude
cd ../myapp-tests && codex

प्रत्येक पंक्ति को उसके अपने टर्मिनल में चलाएँ; प्रत्येक एजेंट के परीक्षण और निर्माण फिर उसकी अपनी फ़ाइलों के विरुद्ध चलते हैं।

क्लाउड कोड के साथ Git वर्कट्रीज़ का उपयोग करना

क्लाउड कोड को हाथ से अपना स्वयं का वर्कट्री देने के लिए, सादे Git के साथ वर्कट्री बनाएं और उसके अंदर claude शुरू करें; एजेंट तब केवल उस फ़ोल्डर को पढ़ता है और संपादित करता है और उस शाखा पर प्रतिबद्ध होता है:

git worktree add ../myapp-auth -b agent/auth
cd ../myapp-auth
claude

क्लाउड कोड का --worktree ध्वज

क्लाउड कोड आपके लिए वर्कट्री बना सकता है। क्लाउड कोड के वर्कट्री दस्तावेज़ीकरण के अनुसार, claude --worktree feature-auth (या -w) worktree-feature-auth नाम की एक नई शाखा पर .claude/worktrees/feature-auth/ के तहत एक वर्कट्री बनाता है, जो रिपॉजिटरी की डिफ़ॉल्ट शाखा से शाखाबद्ध होता है जब तक कि worktree.baseRef सेटिंग अन्यथा न कहती हो। एक .worktreeinclude फ़ाइल प्रत्येक नए वर्कट्री में नजरअंदाज की गई फ़ाइलों जैसे कि .env की प्रतिलिपि बनाती है। बाहर निकलने पर, क्लाउड कोड एक अनाम सत्र से एक साफ़ वर्कट्री और उसकी शाखा को हटा देता है और परिवर्तन या नई प्रतिबद्धताओं के साथ एक को हटाने से पहले पूछता है।

claude --worktree feature-auth

कोडेक्स सीएलआई के साथ गिट वर्कट्रीज़ का उपयोग करना

कोडेक्स सीएलआई उस निर्देशिका में काम करता है जहां से आप इसे शुरू करते हैं, इसलिए प्रति कोडेक्स सत्र एक वर्कट्री प्रत्येक सत्र के संपादन, परीक्षण और प्रतिबद्धताओं को अलग रखता है:

git worktree add ../myapp-tests -b agent/tests
cd ../myapp-tests
codex

कोडेक्स ऐप और कोडेक्स सीएलआई

OpenAI का कोडेक्स ऐप वर्कट्री डॉक्यूमेंटेशन वर्कट्री का वर्णन करता है जो कोडेक्स को एक प्रोजेक्ट में कई चैट चलाने देता है। डिफ़ॉल्ट रूप से वे आपके द्वारा चुनी गई शाखा के आधार पर $CODEX_HOME/worktrees में जाते हैं, और किसी शाखा के बजाय एक अलग HEAD स्थिति में शुरू होते हैं। चैट हेडर में, हैंड ऑफ एक चैट को वर्कट्री और आपके स्थानीय चेकआउट के बीच ले जाता है, और यहां शाखा बनाएं वर्कट्री के काम को एक शाखा में बदल देता है जिसकी आप समीक्षा कर सकते हैं और विलय कर सकते हैं। कोडेक्स सीएलआई के साथ, आप प्रोजेक्ट निर्देशिका से codex चलाते हैं, इसलिए इसे आपके द्वारा बनाए गए वर्कट्री के अंदर शुरू करें।

किसी भी तरह से, ये सामान्य Git वर्कट्री हैं, जो git worktree list और इसे पढ़ने वाले किसी भी Git GUI को दिखाई देते हैं।

एक गिट वर्कट्री जीयूआई: प्रत्येक एजेंट के फ़ोल्डर और शाखा को ट्रैक करना

तीन या चार एजेंटों के चलने के साथ, कठिन हिस्सा ट्रैक रखना है: कौन सी शाखा किस फ़ोल्डर में रहती है, और कौन सा एजेंट अभी भी फ़ाइलें बदल रहा है। GitTree, macOS, Windows और Linux के लिए Git क्लाइंट जो इस ब्लॉग को प्रकाशित करता है (निजी रिपॉजिटरी शामिल है), उन वर्कट्रीज़ को पढ़ता है जिनके बारे में Git पहले से जानता है, जिसमें क्लाउड कोड या कोडेक्स भी शामिल है, और प्रत्येक को इंटरफ़ेस में जगह देता है।

• बाएं पैनल में एक वर्कट्रीज़ अनुभाग। प्रत्येक वर्कट्री, पहले मुख्य एक, उसकी शाखा (या अलग होने पर उसके फ़ोल्डर) द्वारा नामित, इस टैब में खुले एक पर एक चेक मार्क के साथ। लॉक किए गए, अलग किए गए और गायब वर्कट्रीज़ को लेबल किया गया है।
• शाखा युक्तियों पर सहोदर वर्कट्री। प्रतिबद्ध ग्राफ एक दूसरे वर्कट्री को उसकी शाखा टिप पर उसमें होने वाले परिवर्तनों की संख्या के साथ चिह्नित करता है, यह देखने का एक त्वरित तरीका है कि कौन से एजेंट अभी भी संपादन कर रहे हैं। मार्कर पर क्लिक करने से उस वर्कट्री का टैब खुल जाता है।
• आप जहां हैं वहां से एक वर्कट्री बनाएं। कमांड पैलेट में वर्कट्री बनाएं... या इस कमिट से वर्कट्री बनाएं... कमिट पर आपको एक नई शाखा या एक अलग चेकआउट, फिर फ़ोल्डर चुनने की सुविधा मिलती है; इस शाखा के लिए वर्कट्री बनाएं... एक शाखा पर उस शाखा को नए फ़ोल्डर में जांचता है।
• प्रति वर्कट्री एक टैब, अपने स्वयं के टर्मिनल के साथ। वर्कट्री को एक नए टैब में खोलें, इसे किसी भी रिपॉजिटरी की तरह खोलता है, और ग्राफ़ के नीचे अंतर्निहित टर्मिनल आपके स्वयं के शेल के साथ उस वर्कट्री के फ़ोल्डर में शुरू होता है, ताकि आप वहीं से claude या codex शुरू कर सकें।
• लॉक करें, हटाएं, हटाएं, काट-छांट करें और मरम्मत करें। विकल्प कारण से लॉक करें, किसी फ़ोल्डर को स्थानांतरित करें या हटा दें। Git अप्रतिबद्ध परिवर्तनों के साथ एक वर्कट्री को हटाने से इंकार कर देता है, और शाखा रुक जाती है। प्रून स्टेल वर्कट्रीज़ पूर्वावलोकन करता है कि गिट क्या हटाएगा, और रिपेयर वर्कट्री लिंक, आपके द्वारा हाथ से ले जाए गए वर्कट्री से चलाया जाता है, इसे फिर से जोड़ता है।

प्रत्येक क्रिया आपके द्वारा पहले से इंस्टॉल किए गए Git को चलाती है, इसलिए परिणाम कमांड लाइन से मेल खाता है:

GitTree फीचर पृष्ठ ऐप द्वारा की जाने वाली हर चीज को सूचीबद्ध करता है, और Git GUI बनाम कमांड लाइन कवर करता है जब प्रत्येक दृष्टिकोण तेज होता है।

कई एआई एजेंटों के काम का विलय

चूँकि शाखाएँ साझा की जाती हैं, आपका मुख्य वर्कट्री प्रत्येक एजेंट की शाखा को उस क्षण देखता है जब एजेंट प्रतिबद्ध होता है। प्रत्येक को टीम के साथी के अनुरोध की तरह मानें: विश्वसनीय, लेकिन समीक्षा की गई।

1. पहले अंतर पढ़ें। एजेंट की शाखा की तुलना main हंक दर हंक के साथ करें, और असंबंधित संपादन, हटाए गए परीक्षण और नई निर्भरताएं देखें।
2. ओवरलैप की जांच करें। GitTree विलय से पहले टकराव की भविष्यवाणी करता है, शाखा के नाम के साथ चेतावनी देता है कि कब यह main के साथ टकराव होगा, और संकेत देता है कि जब अन्य असंबद्ध शाखाएं समान फ़ाइलों को छूती हैं, तो यह सब आपके कंप्यूटर पर गणना की जाती है। कई एजेंट शाखाओं के साथ, यह दर्शाता है कि कौन सा मर्ज ऑर्डर सबसे कम नुकसान पहुंचाता है।
3. इतिहास साफ़ करें। स्क्वैश चेकपॉइंट उस एजेंट के वर्कट्री के अंदर एक जीयूआई में इंटरैक्टिव रिबेस के साथ प्रतिबद्ध है: Git उस शाखा की जांच नहीं करेगा जिसे किसी अन्य फ़ोल्डर में चेक किया गया है।
4. पुल अनुरोध को मर्ज करें या खोलें। अपने मुख्य वर्कट्री से मर्ज करें, या मर्ज करने, रीबेस करने या पुल अनुरोध शुरू करने के लिए एजेंट की शाखा को GitTree में main पर खींचें।
5. वापस जाने का रास्ता रखें। यदि दो एजेंटों ने एक ही पंक्ति बदल दी है, तो देखें गिट मर्ज विवादों को कैसे हल करें; यदि कोई मर्ज गलत हो जाता है, तो आप मर्ज को पूर्ववत कर सकते हैं, रीसेट कर सकते हैं या रीबेस कर सकते हैं।
6. साफ़ करें। वर्कट्री हटाएँ, फिर मर्ज की गई शाखा हटाएँ।

git switch main
git merge --no-ff agent/auth-refactor
git worktree remove ../myapp-auth
git branch -d agent/auth-refactor

एआई कोडिंग एजेंटों के साथ गिट वर्कट्री के नुकसान

• एक शाखा को दो वर्कट्रीज़ में मजबूर करना। --force एक शाखा पर लड़ने वाले दो फ़ोल्डरों की कीमत पर गिट के इनकार से बच जाता है। इसके बजाय मौजूदा वर्कट्री खोलें; GitTree आपको बताता है कि उस शाखा की जाँच कहाँ की जाती है।
• यह मानते हुए कि वर्कट्रीज़ हर चीज़ को अलग करती है। वे फ़ाइलों को अलग करते हैं, सेवाओं को नहीं। जो एजेंट एक ही पोर्ट पर डेव सर्वर शुरू करते हैं या एक ही स्थानीय डेटाबेस को माइग्रेट करते हैं, वे अभी भी टकराते हैं, इसलिए प्रत्येक वर्कट्री को अपना स्वयं का पोर्ट और परीक्षण डेटाबेस दें।
• Deleting or moving folders by hand. Git keeps a record of every worktree. A deleted folder’s record lingers until git worktree prune (or, much later, Git’s automatic cleanup) removes it; git worktree repair, run inside a folder you moved, reconnects it. Lock worktrees on drives that aren’t always mounted so pruning leaves them alone.
• बिना समीक्षा किए गए कार्य को बलपूर्वक हटाना। git worktree remove परिवर्तनों के साथ एक वर्कट्री को अस्वीकार कर देता है जब तक कि आप --force नहीं जोड़ते, इसलिए पहले अंतर पढ़ें। क्लाउड कोड के गैर-संवादात्मक -p रन उनके वर्कट्री को तब तक लॉक रखते हैं जब तक कि बाद का सत्र उन्हें रिलीज़ नहीं कर देता; किसी एक को स्वयं हटाने से पहले उसे अनलॉक करें।
• एजेंट को चलाने वाले टैब को बंद करना। GitTree में, अंतर्निहित टर्मिनल इसके रिपॉजिटरी टैब से संबंधित है, और टैब को बंद करने से इसके टर्मिनल सत्र बंद हो जाते हैं, जिसमें एक में चलने वाला एजेंट भी शामिल है।
• जितना आप समीक्षा कर सकते हैं उससे अधिक एजेंट चलाना। समीक्षा ही वास्तविक बाधा है। दो या तीन समानांतर कार्यों से शुरुआत करें और एक बार उन्हें मिलाने के बाद और जोड़ लें जो नियमित लगता है।

अपने अगले कार्य पर वर्कट्रीज़ आज़माएँ

शुरू करने के लिए आपको Git के वर्कट्री कमांड की आवश्यकता होती है, और एक GUI कई वर्कट्री को देखना आसान बनाता है। GitTree के पास macOS, Windows और Linux पर एक नि:शुल्क योजना है जो प्रत्येक Git सुविधा को कवर करती है, जिसमें निजी रिपॉजिटरी भी शामिल है, और Nour, AI सहायक, GitTree प्रो के साथ आता है। आपके साइन इन करने के बाद प्रत्येक Git सुविधा निःशुल्क योजना पर होती है, और इसके लिए Git 2.39 या नए की आवश्यकता होती है; Ubuntu 22.04 पर, Ubuntu पर गिट को अपग्रेड करें पहले। Linux इंस्टाल गाइड का पालन करें या GitTree डाउनलोड पेज पर जाएं।