בטא בקרוב. הפיצ׳ר עדיין בפיתוח, ולכן שמות ופרטים עשויים להשתנות לפני השחרור.

לשוניות worktree

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

‏Worktrees נוצרים מ-threads ב-git worktree, מ-Arena ומ-סוכני משנה של משימות עם "worktree": true.

לשוניות worktree מתחת לשורת הכותרת: ‏main, ‏ingot/login עם 2 קבצים שלא נכנסו ל-commit ותג אזהרה 1, ו-ingot/cart עם 2 ו-1. בצ׳אט של Fix login מופיעה השורה src/shared.ts is also being edited in thread 'Cart totals' (ingot/cart)

איך מפעילים

לשוניות ה-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

מקלדת

מקשי המעבר בין הלשוניות עובדים רק כשהפס מוצג.

פעולהmacOSWindows / Linux
הלשונית הבאה⌃⌥]Ctrl+Alt+Shift+PageDown
הלשונית הקודמת⌃⌥[Ctrl+Alt+Shift+PageUp

כשלשונית בפוקוס, החצים ← ו-→ עוברים בין הלשוניות, ‏Enter פותח לשונית ו-Shift+F10 פותח את התפריט שלה. ‏Find Action › Switch to Worktree… מציג את כולן. אפשר לשנות כל קיצור ב-Keymap.

מודעות לצוות

סוכנים שעובדים ב-worktrees יודעים אחד על השני. התכונה פעילה כברירת מחדל, עם לשוניות או בלעדיהן.

הצ׳אט אחרי /team: בלוק Team שאומר ש-threads אחרים של סוכנים עובדים על המאגר הזה ב-git worktrees משלהם, עם ingot/login (you), ‏Fix login, ‏Done, ו-ingot/cart, ‏Cart totals, ‏New, הקבצים שכל אחד ערך ושלא נכנסו ל-commit, ו-src/shared.ts תחת Files edited in more than one worktree

  • בלוק 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.teamAwarenesstrueמספרת לכל סוכן ב-worktree על שאר ה-threads ומזהירה על קבצים משותפים

דסקטופ ודפדפן

לשוניות ה-worktree עובדות אותו דבר באפליקציית הדסקטופ ובגרסת הדפדפן, עם שני הבדלים:

  • ‏Reveal in Finder / Explorer דורש את אפליקציית הדסקטופ. בדפדפן הנתיב מועתק, ומופיעה הודעה על כך.
  • ‏Open in New Window פותח לשונית דפדפן חדשה בגרסת הדפדפן.

ראו גם Threads, חלון הענפים ו-Git.