Git Worktrees

stash किए बिना एक साथ कई branches पर काम करें — हर एक अपने फ़ोल्डर में, और status bar से स्विच करने योग्य।

Worktrees रोज़मर्रा के डेवलपमेंट की सबसे झुंझलाहट भरी समस्याओं में से एक को हल करते हैं: जब आप किसी काम के बीच में हों और आपको branch बदलनी पड़े। Worktrees के साथ आप branch स्विच नहीं करते — आप दूसरी branch को एक अलग फ़ोल्डर में खोलते हैं और दोनों पर एक ही समय में काम करते हैं।

Git Worktree क्या है?

आम तौर पर एक git repository में एक ही working directory होती है — वह फ़ोल्डर जहाँ आपकी फ़ाइलें रहती हैं। किसी भी क्षण उस फ़ोल्डर में ठीक एक branch checked out होती है। अगर आप कोई दूसरी branch देखना चाहते हैं, तो आपको उसे checkout करना पड़ता है, जिससे आपकी फ़ाइलें उस branch के वर्शन से बदल जाती हैं। अगर आपने अपना मौजूदा काम commit नहीं किया है, तो पहले उसे stash करना पड़ता है, जो झंझट भरा और गलतियों की गुंजाइश वाला है।

Worktree उसी git repository से जुड़ी दूसरी (या तीसरी, या चौथी) working directory होती है। हर worktree की अपनी checked-out branch, अपनी फ़ाइल स्थिति और अपनी history होती है। वे सभी एक ही .git फ़ोल्डर और commit history साझा करते हैं — वे बस उसी repo की अलग-अलग खिड़कियाँ हैं।

एक ठोस उदाहरण: आपका AI agent feature/payments पर एक नया फ़ीचर बनाने के बीच में है। कोई सहकर्मी आपसे fix/login-bug पर उनका PR रिव्यू करने को कहता है। अपना फ़ीचर वाला काम stash करने के बजाय, आप fix/login-bug के लिए एक अलग फ़ोल्डर में worktree बनाते हैं। आप वहाँ PR रिव्यू करते हैं, जबकि आपकी फ़ीचर branch अपने मूल फ़ोल्डर में अछूती रहती है।

Worktree बनाएँ

  1. Git panel खोलें — Cmd+G दबाएँ
  2. panel के ऊपर Worktrees टैब पर क्लिक करें
  3. + Add Worktree पर क्लिक करें
  4. एक branch चुनें — सूची में से मौजूदा branch चुनें या नई branch बनाने के लिए नया branch नाम लिखें
  5. नए worktree के लिए फ़ोल्डर की जगह चुनें (डिफ़ॉल्ट रूप से, 1DevTool आपके मौजूदा प्रोजेक्ट फ़ोल्डर के बगल में एक फ़ोल्डर सुझाता है)
  6. Create पर क्लिक करें — 1DevTool git worktree add चलाता है और नए worktree फ़ोल्डर को एक सक्रिय workspace के रूप में खोलता है

नया worktree अब Worktrees टैब में आपके मुख्य worktree के साथ सूचीबद्ध हो जाता है।

Git worktree

Worktree Terminals

जब 1DevTool कोई worktree बनाता है, तो वह उस worktree के फ़ोल्डर तक सीमित एक नया terminal भी खोलता है। terminal के शीर्षक में branch का नाम दिखता है, ताकि आपको हमेशा पता रहे कि आप किस branch में काम कर रहे हैं।

उस terminal में आपका AI agent worktree फ़ोल्डर में काम करता है — वह फ़ाइलें पढ़ और लिख सकता है, कमांड चला सकता है और उस branch पर बदलाव कर सकता है, बिना आपकी दूसरी branches की जानकारी या उनमें दखल के।

Add terminal for git worktree

Git worktree terminal with branch name

आप कई worktrees में एक साथ agents चला सकते हैं। एक agent payments फ़ीचर पर काम करता है, जबकि दूसरा किसी अलग branch पर बग ठीक करता है। दोनों agents का अपना terminal, अपना फ़ाइल संदर्भ और अपनी branch होती है — वे एक-दूसरे से टकरा नहीं सकते।

Status Bar से Worktrees स्विच करें

जब किसी प्रोजेक्ट में linked worktrees होते हैं, तो status bar branch chip के बगल में सक्रिय checkout का नाम दिखाता है — उसके रंग और उसके primary, locked और dirty निशानों के साथ — और Git Client खोले बिना उनके बीच स्विच करने देता है।

The status bar worktree picker with the No terminal in this worktree empty state and the file explorer scoped to that checkout

दो बातें स्विच को वहीं पहुँचाती हैं जहाँ आप उम्मीद करते हैं:

  • जो terminal worktree का है, वह सामने आ जाता है। आप किसी दूसरे checkout के टैब पर नहीं छूटते — किसी कमांड के गलत tree में चल जाने का सबसे आम तरीका यही है।
  • खाली worktree खुद बताता है कि वह खाली है। जिस checkout में कोई दिखने वाला terminal नहीं है, वहाँ कहीं और का बचा हुआ pane दिखाने के बजाय No terminal in this worktree संदेश और Add terminal in this worktree बटन दिखता है।

file explorer भी सक्रिय worktree का अनुसरण करता है, इसलिए आप जो tree ब्राउज़ कर रहे हैं वही tree है जिसमें आपके कमांड चलते हैं।

Worktree हटाएँ

जब आपका worktree से काम पूरा हो जाए — PR merge हो चुका हो, branch डिलीट हो चुकी हो — तो आप उसे साफ़-सुथरे ढंग से हटा सकते हैं:

  1. Git panel खोलें और Worktrees टैब पर जाएँ
  2. वह worktree ढूँढें जिसे आप हटाना चाहते हैं
  3. उसके बगल में trash icon पर क्लिक करें
  4. डिलीट करने की पुष्टि करें

इससे worktree फ़ोल्डर हट जाता है और वह git से deregister हो जाता है (यह git worktree remove के बराबर है)। branch खुद डिलीट नहीं होती — सिर्फ़ working directory हटती है। ज़रूरत पड़ने पर आप worktree को बाद में दोबारा बना सकते हैं।

सुझाव: main को स्थिर रखते हुए अपने AI agent को किसी फ़ीचर branch पर चलाने के लिए worktrees का उपयोग करें। agent गलती से आपकी main branch नहीं बिगाड़ सकता।

Worktrees git की सबसे कम इस्तेमाल होने वाली सुविधाओं में से एक हैं। AI-सहायता प्राप्त डेवलपमेंट के संदर्भ में — जहाँ एक agent मिनटों में दर्जनों फ़ाइलें बदल सकता है — हर agent के काम को उसकी अपनी branch और फ़ोल्डर तक अलग रख पाना एक बड़ा सुरक्षा कवच है।