לשוניות worktree
כשסוכנים עובדים במקביל ב-git worktrees נפרדים, לשוניות ה-worktree מציגות כל אחד מהם כלשונית מתחת לשורת הכותרת. לוחצים על לשונית, ועץ הפרויקט, Local Changes, הטרמינלים החדשים והצ׳אט עוברים כולם לאותו עותק עבודה. הסוכנים ב-worktrees גם יודעים מה האחרים עושים, כך ששני threads לא עורכים את אותו קובץ בלי שאף אחד יודע.
Worktrees נוצרים מ-threads ב-git worktree, מ-Arena ומ-סוכני משנה של משימות עם "worktree": true.

איך מפעילים
לשוניות ה-worktree כבויות כברירת מחדל, וה-worktrees נשארים ב-חלון הענפים כמו קודם. אפשר להפעיל אותן בכל אחד מהמקומות האלה:
- Settings › Version Control › Worktrees › Worktree view: Tabs under the title bar
- המתג Worktree tabs ב-Settings › Features, או באשף ההגדרה הראשונית (Help › Set Up Ingot…)
- Find Action (⌘⇧A, Ctrl+Shift+A) › Show Worktrees as Tabs (ו-Show Worktrees in the Branches Popup כדי לחזור)
| הגדרה | ערכים | ברירת מחדל |
|---|---|---|
ingot.worktrees.view | popup (בחלון הענפים), tabs (לשוניות מתחת לשורת הכותרת) | popup |
מה מוצג בלשונית
מתחת לשורת הכותרת מופיע פס דק (28 פיקסלים). הלשונית הראשונה היא תיקיית הפרויקט עם הענף האמיתי שלה. אחריה מגיעה לשונית לכל thread שעובד ב-worktree, לפי הסדר שבו ה-threads נפתחו. בכל לשונית מוצגים:
- נקודת מצב בצבעים של Threads: רץ, מחכה לכם, הסתיים, שגיאה או במנוחה
- הענף של ה-thread, למשל
ingot/login - מספר הקבצים שלא נכנסו ל-commit ב-worktree הזה, לפי
git status, ומתעדכן כל כמה שניות - **⚠ n** כש-n מהקבצים שה-thread הזה ערך נערכו גם ב-worktree אחר
- כפתור Finish במעבר עכבר: מיזוג, החלה או ביטול, בדיוק כמו Threads › Finish
לחיצה על לשונית מחליפה
לחיצה על לשונית מכוונת את ה-IDE לאותו עותק עבודה:
| חלק | מה מוצג |
|---|---|
| עץ הפרויקט | התיקייה של ה-worktree |
| Local Changes (חלונית Commit) | השינויים של ה-worktree, וה-commits נכנסים לשם |
| טרמינל | טרמינלים חדשים נפתחים בתיקייה של ה-worktree |
| Agents | הצ׳אט של אותו thread |
לשונית הפרויקט מחזירה הכול לתיקיית הפרויקט. סביבת העבודה עצמה לא משתנה: לא נוסף שורש נוסף ולא נוצר קובץ workspace חדש, ועץ הפרויקט פשוט מחליף שורש במקום. רוצים worktree לצד הפרויקט? Open in New Window פותח אותו בחלון משלו.
חוזרים למקום שבו הפסקתם
Ingot זוכר את לשונית ה-worktree הפעילה. אחרי רענון החלון או הפעלה מחדש של Ingot חוזרים לאותה לשונית: עץ הפרויקט, Local Changes, טרמינלים חדשים וחלונית Agents מצביעים שוב על אותו worktree. הלשונית נשמרת לכל תיקיית פרויקט באחסון של סביבת העבודה, כך ששום דבר לא נכתב לתוך המאגר. אם ה-worktree כבר לא קיים (הוא הסתיים, הצ׳אט שלו נסגר או שהתיקייה שלו נמחקה עם git worktree remove), Ingot נפתח בלשונית הפרויקט בלי הודעה.
כותרת הפרויקט מציגה את ה-worktree
כשלשונית worktree פעילה, הכותרת של הסרגל הצדדי מציגה <project> · ⎇ ingot/login. לחיצה על שם הענף פותחת את Switch to Worktree…. בלשונית הפרויקט הכותרת מציגה רק את שם הפרויקט. בסרגל צדדי צר שם הפרויקט מתקצר קודם, והטקסט המלא מופיע ב-tooltip.
תפריט הקליק הימני
| פריט | מה הוא עושה |
|---|---|
| Finish… | ממזג, מחיל או מבטל את ה-worktree |
| Open in New Window | פותח את ה-worktree בחלון משלו |
| Reveal in Finder / Explorer | מציג את התיקייה במנהל הקבצים |
| Copy Path | מעתיק את הנתיב של תיקיית ה-worktree |
מקלדת
מקשי המעבר בין הלשוניות עובדים רק כשהפס מוצג.
| פעולה | macOS | Windows / Linux |
|---|---|---|
| הלשונית הבאה | ⌃⌥] | Ctrl+Alt+Shift+PageDown |
| הלשונית הקודמת | ⌃⌥[ | Ctrl+Alt+Shift+PageUp |
כשלשונית בפוקוס, החצים ← ו-→ עוברים בין הלשוניות, Enter פותח לשונית ו-Shift+F10 פותח את התפריט שלה. Find Action › Switch to Worktree… מציג את כולן. אפשר לשנות כל קיצור ב-Keymap.
מודעות לצוות
סוכנים שעובדים ב-worktrees יודעים אחד על השני. התכונה פעילה כברירת מחדל, עם לשוניות או בלעדיהן.

- בלוק Team. כל ריצה של סוכן ב-git worktree מקבלת בהוראות שלה בלוק Team: שאר ה-threads שעובדים ב-worktrees, עם הענף, שם המשימה והמצב של כל אחד, הקבצים שנגעו בהם בתור האחרון, הקבצים שלהם שלא נכנסו ל-commit, והקבצים שיותר מ-thread אחד ערך. הסוכן מתבקש להימנע מהקבצים האלה, או לציין זאת בתשובה כשהוא חייב לגעת באחד מהם.
- **
/team.** מקלידים/teamבתיבת הצ׳אט כדי להציג את אותו בלוק בצ׳אט, או מריצים Find Action › Show Worktree Team in Chat. - אזהרה על קובץ משותף. כששני threads ב-worktrees עורכים את אותו נתיב, שני הצ׳אטים מקבלים שורה אחת, למשל
src/shared.ts is also being edited in thread 'Cart totals' (ingot/cart). היא מופיעה פעם אחת לכל קובץ בכל thread, ושתי הלשוניות מציגות את מונה ה-⚠.
מכבים ב-Settings › Version Control › Worktrees, או במתג Worktree team awareness ב-Settings › Features ובאשף ההגדרה הראשונית. כשהתכונה כבויה, הבלוק והאזהרות נעלמים; תגי ה-⚠ בלשוניות נשארים כל עוד הלשוניות פעילות.
| הגדרה | ברירת מחדל | מה היא עושה |
|---|---|---|
ingot.agents.teamAwareness | true | מספרת לכל סוכן ב-worktree על שאר ה-threads ומזהירה על קבצים משותפים |
דסקטופ ודפדפן
לשוניות ה-worktree עובדות אותו דבר באפליקציית הדסקטופ ובגרסת הדפדפן, עם שני הבדלים:
- Reveal in Finder / Explorer דורש את אפליקציית הדסקטופ. בדפדפן הנתיב מועתק, ומופיעה הודעה על כך.
- Open in New Window פותח לשונית דפדפן חדשה בגרסת הדפדפן.
ראו גם Threads, חלון הענפים ו-Git.