פרק 5

קיצורי מקלדת ושליטה בטרמינל

ממשק ה-TUI של Grok CLI תוכנן לעבודה מהירה ומקלדתית מלאה. קיצורי המקלדת במערכת קבועים כדי להבטיח אחידות.

בכל שלב ניתן לפתוח את לוח הפקודות המהיר באמצעות הקשת ? או Ctrl+P, או לפתוח את חלונית העזרה באמצעות Ctrl+. (ובטרמינלים שאינם מעבירים נקודה - Ctrl+X).

#מצבי ניווט בהיסטוריה (Scrollback)

Grok CLI תומך בשני מצבי ניווט באזור ההיסטוריה:

מצב פשוט (Simple Mode - ברירת מחדל): ניווט באמצעות מקשי החצים. לחיצה על כל תו או מקש אותיות מחזירה מיד את הפוקוס לשורת הקלט.
מצב Vim (Vim Mode): ניווט מקצועי באמצעות מקשי j/k, קיפול בלוקים עם h/l, העתקת תוכן באמצעות y ומטא-דאטה באמצעות Y. מצב זה מופעל באמצעות הפקודה /vim-mode או הגדרת vim_mode = true בקובץ התצורה תחת [ui].

[!NOTE] יש להבחין בין simple_mode לבין vim_mode בקובץ התצורה: simple_mode מגדיר את אופן עריכת הטקסט בשורת הקלט (האם להשתמש בהתנהגות עריכה בסיסית), בעוד vim_mode שולט על אופן הניווט באזור ההיסטוריה העליון.

#קיצורי מקלדת גלובליים

הקיצורים הבאים פעילים תמיד בכל חלקי הממשק:

קיצור מקשים	פעולה
`Ctrl+P` או `?`	פתיחת לוח הפקודות המהיר (Command Palette)
`Ctrl+O`	מעבר מהיר למצב אישור אוטומטי (Always-approve / YOLO)
`Ctrl+N`	פתיחת סשן חדש ונקי (לחיצה כפולה בתוך שנייה למניעת איפוס בשוגג)
`Ctrl+\`	פתיחה או חזרה מלוח בקרת הסוכנים (Dashboard)
`Ctrl+Q`	יציאה מ-Grok CLI (לחיצה כפולה; בסביבות VS Code משתמשים ב-`Ctrl+D`)
`Ctrl+S`	פתיחת תפריט בחירת סשנים קודמים ושחזורם
`Ctrl+T`	פתיחת חלונית המשימות ותהליכי הרקע
`F2`	פתיחת תפריט ההגדרות הראשי
`Shift+Tab`	מעבר מעגלי בין מצבי העבודה: Normal, Plan ו-Always-approve

בסביבות עריכה ממשפחת VS Code (כולל Cursor, Windsurf ו-Zed), חלק מקיצורי הטרמינל מתנגשים עם העורך: שליחה מיידית ועצירת תור מתבצעת ב-Ctrl+L, פתיחת תוספים נעשית בפקודה /plugins, ויציאה מבוצעת באמצעות Ctrl+D.

#עבודה כאשר הפוקוס בשורת הקלט

קיצור מקשים	פעולה
`Enter`	שליחת ההנחיה. בזמן שהסוכן רץ: הוספת ההנחיה לתור המשימות הבא
`Shift+Enter` או `Alt+Enter`	ירידת שורה בתוך שורת הקלט ללא שליחה
`Ctrl+M`	מעבר למצב עריכה רב-שורתי מורחב
`Tab`	העברת הפוקוס משורת הקלט לאזור ה-Scrollback
`!` (על שדה ריק)	מעבר למצב Shell ישיר להרצת פקודות מערכת
`↑` (על שדה ריק)	דפדוף אחורה בהיסטוריית ההנחיות והפרומפטים שנשלחו
`Ctrl+V` (או `Alt+V` ב-Windows)	הדבקת טקסט או צילום מסך ישירות לתוך הסשן

#ניווט כאשר הפוקוס באזור ההיסטוריה (Scrollback)

פעולה במצב Simple	פעולה במצב Vim	מה הפעולה עושה
`↓` / `↑`	`j` / `k`	גלילה בין פריטים ושורות בהיסטוריה
`Shift+→` / `Shift+←`	`L` / `H`	מעבר מהיר לתור הפעולה הבא או הקודם
`←` / `→`	`h` / `l`	קיפול או פתיחה של בלוק קוד ופלט פקודה
	`y` / `Y`	העתקת תוכן הבלוק הנבחר / העתקת המטא-דאטה
`Enter`	`Enter`	פתיחת הבלוק הנבחר בתצוגת מסך מלא
`Space` או מקש אות	`i` / `Tab` / `Space`	חזרה מיידית לשורת הקלט

#ההבדל המהותי בין Esc לבין Ctrl+C

ניהול ביטולים וניקוי שדות ב-Grok CLI תלוי במצב הממשק:

מצב המערכת	פעולת מקש Esc	פעולת מקש Ctrl+C
תור פעיל רץ (מצב רגיל)	ביטול מיידי של התור, הטיוטה בשורת הקלט נשמרת	לחיצה ראשונה מנקה טיוטה; לחיצה על שדה ריק מבטלת את התור
תור פעיל (Fullscreen + Vim)	מקש Esc אינו מבטל (משמש לחזרה למצב פקודה)	מבטל את התור (לאחר ניקוי הטיוטה)
מצב סרק, יש טיוטה בשדה	לחיצה כפולה תוך 800ms מנקה את הטיוטה	מנקה את הטיוטה בלחיצה בודדת
מצב סרק, שדה ריק ויש היסטוריה	לחיצה כפולה פותחת תפריט חזרה אחורה (Rewind)	אינו מבצע פעולה

[!TIP] לאחר ביטול פעולה באמצעות מקש Esc, מופעל מנגנון השהיה אוטומטי של שנייה אחת המונע פתיחה מקרית של תפריט ה-Rewind במקרה של לחיצות רצופות.

#שליטה בהנחיות בזמן ריצת תור

הוספה לתור (Queue): הקלדת טקסט והקשת Enter מכניסה הודעה לתור, והסוכן יטפל בה מיד עם סיום המשימה הנוכחית.
קטיעה מיידית (Interject): הקשת Ctrl+Enter (או Ctrl+I, וב-VS Code Ctrl+L) קוטעת את הפעולה הנוכחית ושולחת את ההודעה מיד.
שליפת תור ידנית: הקשת Enter על שדה ריק כשיש הודעות ממתינות בתור, שולחת מיד את ההודעה הראשונה שבתור.
שאלת רקע מהירה: שימוש בפקודה /btw <שאלה> מאפשר להציג שאלת אגב מבלי לעצור את המשימה המרכזית.

#תמיכה בעכבר

ממשק ה-TUI תומך בעכבר באופן מלא: ניתן ללחוץ על רשומות היסטוריה כדי לפתוח אותן, לגלול בגלגלת העכבר, וללחוץ בתוך שורת הקלט להצבת הסמן. בלינוקס, לחיצה על הכפתור האמצעי מדביקה את בחירת ה-PRIMARY.

#פתרון בעיות קלט ומיפוי מקשים בטרמינלים

אם קיצורי מקשים מסוימים אינם מגיעים ל-Grok CLI, הריצו /terminal-setup (או /terminal-check, /doctor) לאבחון מדויק:

tmux: כדי שצבעים, לוח גזירים וקיצורים מורחבים יעבדו בצורה חלקה, הוסיפו לקובץ ~/.tmux.conf:
```
set -g default-terminal "tmux-256color"
set -as terminal-features ",*:RGB"
set -g set-clipboard on
set -g allow-passthrough on
```
WezTerm: הוסיפו config.enable_kitty_keyboard = true לקובץ wezterm.lua כדי לאפשר תמיכה ב-Ctrl+Enter ו-Shift+Enter.
iTerm2: יש לוודא תחת Settings → General → Selection שהאפשרות "Applications in terminal may access clipboard" מסומנת (עבור OSC 52).
VS Code / Cursor: אמולטור הטרמינל המובנה אינו מבדיל תמיד בין Shift+Enter ל-Enter. לירידת שורה השתמשו ב-Alt+Enter.

בפרק הבא נלמד כיצד להגדיר כללי פרויקט באמצעות AGENTS.md וכיצד מופעל מנגנון הזיכרון חוצה-הסשנים.