📘 תיעוד 47

לוח מחוונים של סוכנים

לוח המחוונים של הסוכנים מציג כל סשן ברמה העליונה בתהליך ה-pager הזה, סשנים מקומיים ו-forks, מקובצים לפי מצב. ממסך אחד אפשר להציץ, להשיב, לצרף, לנעוץ, לשנות שם, לעצור, או לשגר סוכן חדש. תת-סוכנים לא מופיעים ברשימה. הם רצים תחת ההורה שלהם, שכבר מציג כשיש עבודה בתהליך.

זה לא חלון הסוכנים (/config-agents / /agents, הגדרות ופרסונות), לא בורר הסשנים (/resume / Ctrl+R, שיחות קודמות על הדיסק), ולא ממשק ריצות ה-workflow (/workflow runs).

#פתיחת לוח המחוונים

• grok dashboard: הפעלת ה-TUI אל לוח המחוונים.
• /dashboard (כינויים /agents-dashboard, /sessions): פתיחה מתוך סשן.
• Ctrl+\: אותה תצוגה כמו פקודת הלוכסן.
• ← על פרומפט ריק: מסשן או ממסך הפתיחה, כשהפרומפט בפוקוס. טיוטה משאירה את ← כהזזת סמן, ה-scrollback משאיר אותו ככיווץ, ובורר או צופה שפתוחים מעל הפרומפט (בורר ה-rewind, פירוט מטרה, תצוגה מקדימה של תוכנית, תצוגת מסך מלא של תת-סוכן) משאירים אותו.

מוסתר במצב מינימלי. הגדר GROK_AGENT_DASHBOARD=0 או [dashboard].enabled = false כדי לבטל.

לוח המחוונים של סביבת העבודה פועל כברירת מחדל, אלא אם הגדרות מרוחקות מכבות אותו עבור החשבון שלך. כדי לחזור ללוח המחוונים הקודם, הגדר [features] workspace_dashboard = false או GROK_WORKSPACE_DASHBOARD=0 והפעל מחדש (סדר עדיפויות). זה לא אותו דבר כמו GROK_AGENT_DASHBOARD=0 או [dashboard].enabled = false, שמסתירים את לוח המחוונים לגמרי.

#מה רואים

  + New Agent                                Open Previous /resume │ Worktree Ctrl+w

▌● reviewer · audit token flow    Awaiting your input            2m
 ● implementer · fix login bug    Running: cargo test           12m
 ⋅ refactor · feat/login          Responding…                   24m
 ○ housekeeping                   idle                           1h
 ● implementer · add login tests  8 tools · 1.2k tok            14m
╭────────────────────────────────────────── main · ~/xai · Ctrl+l ╮
│ ❯ Dispatch a new agent                                          │
╰─ dispatch ──────────────────────────────────────────────────────╯
 ↑/↓ select (peek) · Enter open · Ctrl+R rename · Ctrl+T pin · Ctrl+X stop · ? help · Esc new

הגבול העליון של תיבת השיגור מראה איפה סוכן חדש ירוץ: ענף ה-git ותיקיית העבודה, ואחר כך מקש Ctrl+l שמשנה אותם, באותו טקסט עמום כמו המודל והמצב על הגבול התחתון. בטרמינל צר התיקייה משמיטה קודם תיקיות מובילות (…/xai), אחר כך נעלם רמז המקש, אחר כך הענף, ורק אז נחתכת התיקייה האחרונה. לחץ על המיקום (או לחץ Ctrl+L) כדי לבחור תיקייה אחרת. /cd <path> עושה אותו דבר מתיבת השיגור. מעבר לתיקייה שהגדרות הפרויקט שלה יגרמו ל-Grok לשאול בהפעלה שואל את אותה שאלה קודם. y שומר אמון ועובר, אחרי שהשאלה מוצגת חצי שנייה. כל מקש אחר נשאר. בבורר התיקיות הזה, הקלדת נתיב או לחיצה ממקדת את שדה הנתיב, כך ש-/home/me עובד מיד. במצב vim, / או i ממקדים אותו קודם, כמו ב-/resume. Esc יוצא מהשדה, אחר כך מנקה את הנתיב שהוקלד, ואחר כך סוגר את הבורר. במצב vim, יציאה מהשדה גם מנקה את הנתיב. כשהתיקייה שנבחרה נמצאת במאגר git, Ctrl+W או לחיצה מחליפים את [worktree:on/off]. בכל מקום אחר Ctrl+W מוחק מילה מהנתיב שאתה מקליד.

שורת הפעולות בראש מכילה את + New Agent (יעד ברירת המחדל של הסמן כשאין שורה נבחרת) ומימין את Open Previous (בורר הסשנים, רק בלוח המחוונים של סביבת העבודה) ואת מתג ה-worktree. → / ← מזיזים את הסמן לאורך השורה בסדר הזה, ועוצרים בכל קצה. כמו כל חץ בלוח המחוונים, הם מנווטים כשהרשימה בפוקוס (Tab) או כשתיבת השיגור ריקה, ועורכים את הטיוטה אחרי שהקלדת משהו. במצב חיפוש התיבה הריקה היא עדיין השאילתה, ולכן הם עורכים. במצב vim, l / h עושים אותו דבר, אבל צריכים שהרשימה בפוקוס, ונשארים בלי תגובה במצב חיפוש. Enter פועל כמו לחיצה על הפריט שבפוקוס: יצירה, פתיחת הבורר, או החלפת מצב worktree. Esc חוזר אל + New Agent. אותן פעולות תמיד זמינות בלחיצה, או דרך /resume / Ctrl+W. כשמצב worktree פועל בתוך מאגר git, השורה מציגה + New Agent in Worktree / Disable Worktree, והשיגור הבא יוצר את הסוכן ב-git worktree חדש.

כל שורה היא סוכן ברמה העליונה. המיון הוא לפי מצב (Needs input → Working → Idle → Inactive → Completed → Failed), כדי ששורות מאותו מצב ישבו יחד, או לפי תיקיית עבודה (Ctrl+G מחליף). Inactive הוא סשנים שקיימים רק ברשימה (roster), בבעלות תהליכי pager אחרים שהתהליך הזה לא טען. זה רעש רקע, ולכן המקטע מתחיל מכווץ (הרחבה ב-→ או בלחיצה).

שורות נעוצות שומרות על הסדר הידני שלהן בשני מצבי הקיבוץ. פעילות הסוכן ועדכונים אחרונים לא מזיזים אותן. Shift+↑ / Shift+↓ משנים את הסדר שלהן.

כדי ש-Idle יישאר נוח לסריקה, רק סוכני ה-idle העדכניים ביותר נשארים גלויים: 8 הטריים ביותר, ובנוסף כל מי שהיה פעיל בשעה האחרונה. השאר מתקפלים לשורת "N more" בתחתית הקבוצה. בחר אותה ולחץ Enter / → (או לחיצה) כדי להרחיב, ו-← כדי לקפל בחזרה. כותרת Idle תמיד מציגה את הסך האמיתי. הקיפול מושעה כשמסנן או חיפוש פעילים.

סמלי המצב תואמים לרשימות סשנים אחרות ב-Grok Build:

• ⠠⠜: מחוון נקודות ברייל בן שני תאים, מונפש עבור Working (נקודות ASCII כמו :. בקונסולת Windows הישנה)
• ●: עיגול מלא עבור Needs input, Completed, Failed, Blocked (צבע: צהוב / ירוק / אדום / ענבר)
• ○: עיגול חלול עבור Idle ו-Inactive

שורה נשארת Working כל עוד יש לה עבודת רקע חיה, גם אם התור שלה הסתיים: משימת רקע, monitor, /loop מתוזמן פעיל, תת-סוכן רץ, או workflow רץ. ה-chips של השורה סופרים כל סוג. Ctrl+X על השורה עוצר את התור שלה, משימות רקע, לולאות, תת-סוכנים וריצות workflow. שני סוגים מחוץ לטווח שלו: תת-הסוכנים של סשן שרץ על מחשב אחר, וריצות workflow בסשן שלא יכול לנהל אותן. שורה שנשארו בה רק אלה עדיין יכולה להיכנס לארכיון או להימחק. שורה שה-workflow שלה מושהה בתקציב הסוכן שלה ממתינה לך: היא מציגה Needs input עם שורה Pending: agent budget for <workflow> עד שהריצה מקבלת תקציב גבוה יותר או עד שאתה עוצר אותה. העצירה שואלת פעם אחת: Ctrl+X הראשון דורך, והשני בתוך 2 שניות עוצר את עבודת הסשן, כולל הריצה המושהית. כל עוד תור או פרומפט בתור משאירים את השורה במצב Working, Ctrl+X עוצר את העבודה הזו, וכל עבודת רקע חיה אחרת, אבל משאיר את הריצה המושהית, שאז ממתינה לך שוב. אם השורה משתנה בין שתי הלחיצות, הלחיצה השנייה נחשבת ללחיצה ראשונה על השורה כפי שהיא באותו רגע: היא עוצרת מיד ריצה שחודשה, או תור שהתחיל, ורק דורכת מחיקה או ארכוב של סשן שהריצה שלו הסתיימה.

כל קבוצה מתחילה בכותרת ובמספר השורות שלה. בקיבוץ לפי תיקייה, הכותרת היא נתיב התיקייה (לדוגמה ~/code/xai 3), ושורות נעוצות יושבות תחת כותרת Pinned משלהן. בניגוד לכותרות מקטעי המצב שמתוארות בהמשך, כותרות תיקייה רק מסמנות את הקבוצה: ניווט ולחיצות מדלגים עליהן, והן לא מתכווצות.

Dashboard preview נמצא תחת Appearance ב-/settings (חפש "preview"). הרשימה מקבלת מקום כשמכבים את חלונית התצוגה המקדימה והתשובה. צריך לפתוח סשן כדי להשיב או לענות על הרשאות כשהתצוגה המקדימה כבויה. פרומפט הסוכן החדש נשאר זמין. ההגדרה נשמרת בין הפעלות. אפשר להדליק אותה שוב באותו מקום. [ui] dashboard_preview = true ב-config.toml גם מפעיל אותה.

קלט השיגור משתמש באותו עיצוב פרומפט כמו תצוגת הסוכן. לחץ Ctrl+/ כדי להעביר אותו למצב חיפוש: הקידומת ❯ הופכת ל-Search: צהוב, וההקלדה מסננת את הרשימה בזמן אמת במקום לשגר.

#קיצורי מקשים

בקיבוץ לפי מצב, לכל קבוצה יש כותרת מקטע (לדוגמה Working, Idle) עם סמן ▸/▾. בחר כותרת ולחץ → / ← כדי להרחיב או לכווץ (l / h במצב vim). לחיצה מחליפה. ריחוף מבהיר. מצב הכיווץ נשמר כל עוד לוח המחוונים פתוח. Inactive מתחיל מכווץ בכל פעם שה-pager עולה. הרחבה שלו נשארת עד היציאה.

פתיחת שורה מציגה את שיחת הסוכן בתצוגת הפרטים. שורת הכותרת של הסשן עצמה עושה את העבודה, בלי פס כותרת נוסף: שם הסוכן מוביל אותה (name │ main ~/xai, מושמט בסשן בלי שם), ומימין, אחרי ה-chips הרגילים, יושבים ‹ 2/5 › (המיקום שלך בין סוכני לוח המחוונים, מוסתר כשיש רק אחד) ו-[Dashboard]. המקשים עוברים לסוכן המצורף. Esc / Ctrl+\ (או [Dashboard]), או ← על פרומפט ריק, חוזרים ללוח המחוונים. ‹ / › עוברים בין סוכנים. סרגל הקיצורים מציג Ctrl+\: back to dashboard. שים לב: Esc רק חוזר. /exit בתוך הסוכן סוגר את הסשן (toast בלוח המחוונים: "Session closed"). ראה השלמה או סגירה של סשן לגבי תורות רצים, הסשן היחיד, ולוח המחוונים של סביבת העבודה.

כל סשן שבו לוח המחוונים מופעל מציג [Dashboard] בכותרת שלו, לא רק סשנים שנפתחו מלוח המחוונים. לחיצה עליו זהה ל-Ctrl+\. ביטול לוח המחוונים (ראה בראש הדף) מסיר גם את הכפתור.

Ctrl+X בתצוגת הפרטים תלוי במצב. כשתור רץ, הוא מבטל את התור (כמו Ctrl+C, כולל פרומפט ה-keep-subagents) ואף פעם לא סוגר את הסשן. אחרת, במצב idle, פקודת לוכסן בביצוע, או ביטול שעדיין ממתין, Ctrl+X דורך אישור: לחץ שוב בתוך 2 שניות כדי לסגור את הסשן ולחזור ללוח המחוונים. כל מקש אחר מבטל את האישור. תור שמתחיל בתוך החלון הופך את הלחיצה המאושרת לביטול. (אם Ctrl+X הוא גם צירוף דף הקיצורים בטרמינל שלך, השתמש ב-Ctrl+. בתוך תצוגת הפרטים.)

ראה קיצורי מקלדת.

#השלמה או סגירה של סשן

אין פקודת "mark completed". מצב השורה נגזר מהסוכן:

• Completed / Failed כשהעבודה מסתיימת מעצמה (התור הסתיים ואין עבודת רקע שעדיין רצה).
• Ctrl+X פעם אחת בזמן שתור רץ מבטל את התור.
• בתצוגת הרשימה, Ctrl+X פעמיים (בתוך 2 שניות) מוחק לצמיתות את הסשן שנבחר (כמו /delete). רחף מעל שורת idle/done כדי להחליף את הגיל ב-[✗], ולחץ פעמיים לאישור.
• בתצוגת הפרטים, Ctrl+X פעמיים (בתוך 2 שניות) סוגר את הסשן במקום. הוא מסרב לסגור את הסשן היחיד. הסגירה רק מסירה אותו מה-pager הזה: ההיסטוריה נשמרת, אף hook לא רץ בסגירה, וה-hooks של SessionEnd רצים כש-Grok יוצא. בחירה בו מ-/resume לפני כן פותחת אותו מחדש בלי SessionStart חדש. סשן סגור יוצא מלוח המחוונים עד ש-Grok יוצא או עד ש-/resume פותח אותו מחדש. סשן נעוץ שומר על השורה שלו. סשן סגור שלקוח אחר מביא למצב Working או Needs input נשאר ברשימה כל עוד הוא באחד משני המצבים.
• בתצוגת הפרטים, /exit סוגר את הסשן בלי למחוק אותו (Esc רק חוזר). בזמן שתור רץ, /exit הראשון רק עוצר אותו ומשמיט את הפרומפטים שבתור שלו, כמו Ctrl+X. כשיש רק סשן אחד, /exit יוצא מ-Grok, גם במהלך תור. בלוח המחוונים של סביבת העבודה, /exit מעביר סשן idle לארכיון במקום, גם אם הוא היחיד. תור רץ נעצר קודם, והפרומפטים שבתור שלו מושמטים. /exit הבא עוצר את עבודת הרקע של הסשן: משימות רקע, משימות מתוזמנות, תת-סוכנים וריצות workflow. ריצה שמושהית בתקציב הסוכן שלה נשארת בזמן שתור או פרומפט בתור נעצרים. ברגע שהשורה ממתינה לה, /exit שואל קודם, וה-/exit הבא עוצר אותה. הסשן נשאר פתוח עד שלא נשאר מה לעצור. בזמן שהסשן נטען, /exit לא עושה כלום.
• /delete בתוך סוכן מצורף מוחק את הסשן וחוזר ללוח המחוונים.

אין דגל השלמה ידני. השתמש ב-/exit כדי לעזוב סשן בלי למחוק היסטוריה.

#קלט שיגור

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

• טקסט חופשי: סשן חדש ברמה העליונה שמתחיל עם הפרומפט. הטקסט אף פעם לא מטופל כמסנן (גם אם הוא מתחיל ב-/, s:, a:, או #). הסינון הוא מצב החיפוש של Ctrl+/. / מוביל מריץ פקודת לוכסן גלובלית ל-pager.
• קלט ריק: פתיחת השורה שנבחרה, או יצירת סוכן חדש כש-+ New Agent בפוקוס.

/usage פותח את חלון השימוש מעל לוח המחוונים. ללוח המחוונים אין סשן, ולכן לשונית Usage limit מציגה את מכסת החשבון שלך, בעוד שתי לשוניות הסשן מציגות "No active session". פתח סוכן כדי לראות את ההקשר ואת סכומי הטוקנים שלו (/context ו-/session-info עובדים רק בתוך סשן). Esc או [✗] סוגרים אותו.

Ctrl+S אחרי הקלדה משגר וגם מצרף. Enter רגיל נשאר בלוח המחוונים, כדי שאפשר לשגר כמה סשנים. Shift+Enter / Alt+Enter מכניסים שורה חדשה. התיבה גדלה עם הטיוטה (עד גבול, ואחר כך גוללת). כש-multiline פועל (/multiline, Ctrl+M, או /settings ← Start in multiline), Enter ו-Shift+Enter / Alt+Enter מתחלפים בתיבת השיגור ובתשובת ההצצה.

פרומפטים ריקים, או שמכילים רק רווח, מתעלמים מהם. פרומפטים מעל 64 KiB נדחים עם toast.

#פוקוס: שורת קלט ↔ רשימת סקירה (Tab)

שני אזורי פוקוס: קלט השיגור ורשימת הסקירה. Tab מחליף ביניהם. הקלט הלא פעיל מעמעם את המסגרת שלו ומסתיר את הסמן.

בפתיחה, הפוקוס ברירת המחדל הוא רשימת הסקירה כשיש לפחות סוכן אחד (כך ש-↑/↓ / vim j/k מנווטים מיד). כשאין סוכנים, הפוקוס נשאר על קלט השיגור. בכל מקרה, הסמן מתחיל על + New Agent (אף שורת סוכן לא נבחרת מראש).

• הקלט בפוקוס: הקלדת פרומפט לסשן חדש. פרומפט ריק: ↑/↓ מנווטים בין שורות. לא ריק: הזזת הסמן. Esc מוציא פוקוס אל הרשימה (הטיוטה נשמרת).
• הסקירה בפוקוס: ↑/↓ (ו-vim j/k) זזים בין שורות. Enter פותח את הסוכן המודגש (על + New Agent, שולח טיוטה שהוקלדה או יוצר סשן חדש). Esc נשאר על הרשימה וצועד אחורה: ניקוי מסנן, אחר כך ביטול בחירה (← + New Agent), אחר כך יציאה. Tab, i (vim), או כל מקש להדפסה מחזירים לקלט.

#לוח הצצה

בחירת שורת סוכן מציגה את לוח ההצצה במקום תיבת השיגור. כשאין שורה נבחרת (+ New Agent, או אחרי Esc), תיבת השיגור חוזרת. בחרו שורה כדי לדבר עם סוכן קיים. בטלו את הבחירה כדי להתחיל סוכן חדש.

מלמעלה למטה: כותרת (סוג התגובה האחרונה: Thinking / Thought / Response / Edit / Read / Bash / …, וזמן), התגובה האחרונה (עם גלישת מילים, עד ~3 שורות. … כשהיא מקוצרת), ושדה קלט חי ❯ reply.

המודל של הסוכן הנבחר, ובמצב always-approve (yolo), דגל always-approve, יושבים על הגבול התחתון של הלוח (אותו חריץ תג כמו בתיבת השיגור), כולל בזמן מענה על שאלות. שורות הרשימה כבר לא חוזרות על תגי מודל או always-approve.

Shift+Tab מחליף במחזור את מצב הסוכן שמוצג בהצצה (Normal → Plan → Auto-review (כשמופעל) → Always-approve → Normal) על הסוכן החי. בתיבת השיגור, Shift+Tab רק מציב מצב לסוכן הבא.

בניגוד לשיגור (הפעלות חדשות בלבד), תשובת ההצצה מדברת עם הסוכן הנבחר:

• הקלידו אל ❯ reply, ואז Enter כדי לשלוח. סוכנים idle מתחילים מיד. סוכנים עסוקים מכניסים לתור את ההודעה (כמו בהנחיית תצוגת הסוכן). Ctrl+S עונה ופותח את תצוגת הפרטים. Shift+Enter / Alt+Enter מוסיפים שורה חדשה (התשובה גדלה עם הטיוטה).
• תשובה ריקה + Enter פותחת את הסוכן.
• ↑/↓ מזיזים את הסמן ברגע שיש תוכן בתשובה. כשהשדה ריק (או לא ממוקד דרך Tab), ↑/↓ מחליפים את הסוכן הנבחר: הלוח עוקב, וטיוטה שהוקלדה חלקית נמחקת כדי שלא תגיע לסוכן הלא נכון. (Tab אל הרשימה כדי לנווט בזמן שיש טיוטה בתשובה.)
• Esc מבטל בחירה: קודם מנקים תשובה שהוקלדה, אחר כך מבטלים את הבחירה וממקדים את + New Agent.
• Tab מחליף מיקוד בין התשובה לרשימת השורות. מקש להדפסה ממקד מחדש את התשובה.
• עורך הנחיה מלא (כמו שיגור / הנחיית סוכן): chips של הדבקה מרובת שורות, בחירה בעכבר, ניווט בין מילים, Ctrl+A/Ctrl+E, Alt+Backspace, Ctrl+W/Ctrl+U/Ctrl+K, undo, בחירה עם Shift וחצים, Ctrl+Shift+V הדבקה בתוך השורה. @ פותח את בורר הקבצים ששורשו בתיקיית העבודה של הסוכן שמוצג בהצצה. הרשימה הנפתחת צפה מעל הלוח. צירופי המקשים של Dashboard (Ctrl+X עצירה, Ctrl+T נעיצה, Shift+↑/↓ סידור מחדש, …) עדיין גוברים בזמן שהלוח פתוח.
• שאלת permission / ask-tool ממתינה: ❯ reply מוסתר. במקומו מוצגת רשימת אפשרויות. ↑/↓ מסמנים, Enter עונה, 1 עד 9 עונים ישירות. טקסט שהוקלד, הודבק או הוכתב מחוץ לNo / Other בזמן שהכרטיס מוצג (לא נוסף לתשובה), ותשובה או הכתבה שנלכדו לפני הכרטיס, נשמרים בהמתנה. ספרות ו-Enter מפסיקים אז לענות עד Esc, או ↑/↓ בזמן שאפשרות מסומנת. רמז מציין זאת. כרטיס מחליף נשאר מוחזק. בזמן שNo / Other מסומן, ספרות הן טקסט כמו כל מקש אחר. ↑/↓ בוחרים אפשרות אחרת. No / reject בטקסט חופשי ו-Other של ask-tool מקבלים תשובה מוקלדת בשורת הטקסט החופשי. טפסי Ask מרובי שאלות עוברים אחת בכל פעם ((i/N)). כל שאלה היא כרטיס חדש. תשובה שכבר שם מתחילה את הכרטיס כמוחזק עד ה-Esc שלו. טפסים של בחירה מרובה דורשים את התצוגה של הסוכן עצמו.

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

#חיפוש / סינון (Ctrl+/)

Ctrl+/ מחליף מצב חיפוש כדי שהקלדה רגילה תמיד משגרת. הקידומת מתחלפת מ-❯ ל-Search: צהוב. כל הקשה מסננת את הרשימה בזמן אמת.

• Enter: אישור. שומרים את הסינון וחוזרים להנחיית השיגור.
• Esc או Ctrl+/: ביטול. מנקים את הסינון ויוצאים מהחיפוש.
• ↑ / ↓: ניווט בשורות המסוננות.

קידומות (רק בתוך מצב חיפוש):

• a:<name>: תווית סוכן (תת מחרוזת בלי תלות ברישיות. persona / תפקיד).
• s:<state>: מצב שורה: working, idle, completed, failed, needs-input, blocked ומילים נרדפות (busy/running/done/וכו').
• #<text>: התאמת תת מחרוזת על #<text> (# מילולי בתוויות).
• כל דבר אחר: תת מחרוזת על התווית + תיקיית העבודה.

#התמדה

העדפות לכל משתמש תחת [dashboard] ב-~/.grok/config.toml:

[dashboard]
enabled = true
grouping = "state"   # or "directory"
pinned   = ["top:<session_id>"]
reorder  = ["top:<session_id>"]

רשומות pinned/reorder משתמשות ב-session id (לא בחריץ סוכן לכל תהליך), ולכן הן שורדות הפעלות מחדש.