Git Worktrees
stashing کے بغیر ایک ساتھ کئی برانچز پر کام کریں — ہر ایک اپنے فولڈر میں، اور اسٹیٹس بار سے سوئچ کرنے کے قابل۔
Worktrees روزمرہ ڈیولپمنٹ کے سب سے پریشان کن مسائل میں سے ایک کو حل کرتے ہیں: جب آپ کسی کام کے بیچ میں ہوں تو برانچ بدلنے کی ضرورت پڑ جانا۔ worktrees کے ساتھ آپ برانچ سوئچ نہیں کرتے — آپ دوسری برانچ کو دوسرے فولڈر میں کھولتے ہیں اور دونوں پر ایک ہی وقت میں کام کرتے ہیں۔
Git Worktree کیا ہے؟
عام طور پر ایک git ریپوزٹری کی ایک ہی ورکنگ ڈائریکٹری ہوتی ہے — وہ فولڈر جہاں آپ کی فائلیں موجود ہوتی ہیں۔ کسی بھی لمحے اس فولڈر میں بالکل ایک برانچ چیک آؤٹ ہوتی ہے۔ اگر آپ کسی دوسری برانچ کو دیکھنا چاہیں تو اسے چیک آؤٹ کرنا پڑتا ہے، جو آپ کی فائلوں کو اس برانچ کے ورژن سے بدل دیتا ہے۔ اگر آپ نے اپنا موجودہ کام commit نہیں کیا تو پہلے اسے stash کرنا پڑتا ہے، جو تکلیف دہ اور غلطیوں کا باعث بننے والا عمل ہے۔
Worktree ایک دوسری (یا تیسری، یا چوتھی) ورکنگ ڈائریکٹری ہے جو اسی git ریپوزٹری سے منسلک ہوتی ہے۔ ہر worktree میں اس کی اپنی برانچ چیک آؤٹ ہوتی ہے، اس کی اپنی فائل اسٹیٹ اور اپنی ہسٹری ہوتی ہے۔ سب ایک ہی .git فولڈر اور commit ہسٹری شیئر کرتی ہیں — یہ بس ایک ہی ریپو کی مختلف کھڑکیاں ہیں۔
ایک ٹھوس مثال: آپ کا AI ایجنٹ feature/payments پر نیا فیچر بنانے کے بیچ میں ہے۔ ایک ساتھی آپ سے fix/login-bug پر اپنا PR ریویو کرنے کو کہتا ہے۔ اپنا فیچر کا کام stash کرنے کے بجائے آپ fix/login-bug کے لیے الگ فولڈر میں ایک worktree بنا لیتے ہیں۔ آپ وہاں PR ریویو کرتے ہیں جبکہ آپ کی فیچر برانچ اپنے اصل فولڈر میں جوں کی توں رہتی ہے۔
Worktree بنائیں
- Git panel کھولیں — Cmd+G دبائیں
- پینل کے اوپر Worktrees ٹیب پر کلک کریں
- + Add Worktree پر کلک کریں
- ایک برانچ چنیں — فہرست میں سے موجودہ برانچ، یا نئی برانچ بنانے کے لیے نیا نام لکھیں
- نئے worktree کے لیے فولڈر کا مقام چنیں (بطور ڈیفالٹ 1DevTool آپ کے موجودہ پروجیکٹ فولڈر کے برابر میں ایک فولڈر تجویز کرتا ہے)
- Create پر کلک کریں — 1DevTool
git worktree addچلاتا ہے اور نئے worktree فولڈر کو ایک فعال workspace کے طور پر کھول دیتا ہے
نیا worktree اب Worktrees ٹیب میں آپ کے مرکزی worktree کے ساتھ درج ہو جاتا ہے۔

Worktree ٹرمینلز
جب 1DevTool کوئی worktree بناتا ہے تو وہ اسی worktree کے فولڈر تک محدود ایک نیا ٹرمینل بھی کھولتا ہے۔ ٹرمینل کے ٹائٹل میں برانچ کا نام نظر آتا ہے تاکہ آپ کو ہمیشہ معلوم رہے کہ آپ کس برانچ میں کام کر رہے ہیں۔
اس ٹرمینل میں آپ کا AI ایجنٹ worktree فولڈر میں کام کرتا ہے — وہ فائلیں پڑھ اور لکھ سکتا ہے، کمانڈز چلا سکتا ہے، اور اس برانچ پر تبدیلیاں کر سکتا ہے، بغیر آپ کی دوسری برانچوں کی خبر رکھے یا ان میں مداخلت کیے۔


آپ کئی worktrees میں ایک ساتھ ایجنٹس چلا سکتے ہیں۔ ایک ایجنٹ payments فیچر پر کام کرتا ہے جبکہ دوسرا کسی اور برانچ پر بگ ٹھیک کرتا ہے۔ دونوں ایجنٹس کا اپنا ٹرمینل، اپنا فائل کانٹیکسٹ اور اپنی برانچ ہے — وہ ایک دوسرے سے ٹکرا نہیں سکتے۔
اسٹیٹس بار سے Worktrees سوئچ کریں
جب کسی پروجیکٹ میں لنکڈ worktrees ہوں تو اسٹیٹس بار برانچ چپ کے ساتھ فعال checkout کا نام دکھاتا ہے — اس کے رنگ اور primary، locked اور dirty نشانات کے ساتھ — اور Git Client کھولے بغیر ان کے درمیان سوئچ کرنے دیتا ہے۔

دو چیزیں یقینی بناتی ہیں کہ سوئچ وہیں پہنچے جہاں آپ توقع کرتے ہیں:
- جو ٹرمینل worktree سے تعلق رکھتا ہے وہ سامنے آ جاتا ہے۔ آپ کسی دوسرے checkout کے ٹیب پر نہیں رہ جاتے — یہی وہ سب سے عام طریقہ ہے جس سے کمانڈ غلط ٹری میں چل جاتی ہے۔
- خالی worktree خود بتاتا ہے۔ جس checkout میں کوئی نظر آنے والا ٹرمینل نہ ہو وہ کسی اور جگہ کے بچے ہوئے پین کے بجائے No terminal in this worktree اور Add terminal in this worktree بٹن دکھاتا ہے۔
فائل ایکسپلورر بھی فعال worktree کے ساتھ چلتا ہے، اس لیے جس ٹری کو آپ براؤز کر رہے ہیں وہ وہی ہے جس میں آپ کی کمانڈز چل رہی ہیں۔
Worktree ہٹائیں
جب آپ کا worktree سے کام ختم ہو جائے — PR merge ہو چکا ہو، برانچ حذف ہو چکی ہو — تو آپ اسے صاف طریقے سے ہٹا سکتے ہیں:
- Git panel کھولیں اور Worktrees ٹیب پر جائیں
- وہ worktree تلاش کریں جسے آپ ہٹانا چاہتے ہیں
- اس کے ساتھ موجود trash آئیکن پر کلک کریں
- حذف کرنے کی تصدیق کریں
یہ worktree فولڈر کو ہٹا دیتا ہے اور اسے git سے ڈی رجسٹر کر دیتا ہے (git worktree remove کے مساوی)۔ برانچ خود حذف نہیں ہوتی — صرف ورکنگ ڈائریکٹری ہٹتی ہے۔ ضرورت پڑنے پر آپ بعد میں worktree دوبارہ بنا سکتے ہیں۔
ٹپ: اپنے AI ایجنٹ کو فیچر برانچ پر چلانے کے لیے worktrees استعمال کریں تاکہ main مستحکم رہے۔ ایجنٹ غلطی سے آپ کی main برانچ کو خراب نہیں کر سکتا۔
Worktrees git کے سب سے کم استعمال ہونے والے فیچرز میں سے ہیں۔ AI کی مدد سے ڈیولپمنٹ کے تناظر میں — جہاں ایک ایجنٹ منٹوں میں درجنوں فائلوں میں تبدیلیاں کر سکتا ہے — ہر ایجنٹ کے کام کو اس کی اپنی برانچ اور فولڈر تک الگ رکھنا ایک اہم حفاظتی جال ہے۔