📘 תיעוד 3

תמיכה בטרמינל

גרוק מצייר את הממשק בעזרת רצפי escape של טרמינל, בשביל צבע, לוח העתקה, עכבר ושליטה במסך מלא. חלק מהטרמינלים, מהמרבבים (multiplexers) ומהסשנים של SSH מטפלים בזה אחרת. הריצו /terminal-setup (כינויים: /terminal-check, /terminal-info) בתוך גרוק כדי לראות מה זוהה, אילו נתיבי לוח העתקה פעילים, ואילו בעיות נמצאו יחד עם התיקונים.

#הצבעים נראים לא נכון

הגדירו COLORTERM=truecolor בפרופיל ה-shell. בתוך tmux, הפעילו גם RGB של 24 סיביות:

# ~/.tmux.conf
set -g default-terminal "tmux-256color"
set -as terminal-features ",*:RGB"
set -g set-clipboard on
set -g allow-passthrough on

שתי השורות האחרונות מתקנות גם העברה (passthrough) של לוח העתקה ושל התראות. טענו מחדש עם tmux source-file ~/.tmux.conf.

#ההעתקה לא מגיעה ללוח ההעתקה

גרוק כותב ללוח ההעתקה המקורי של מערכת ההפעלה, ל-paste buffer של tmux כשעובדים בתוך tmux, ופולט OSC 52 במקרים מרוחקים (SSH, קונטיינרים, לינוקס). שני חסמים נפוצים:

• iTerm2 מתעלם מ-OSC 52 עד שמפעילים Settings → General → Selection → "Applications in terminal may access clipboard".
• Apple Terminal מתעלם מ-OSC 52 לחלוטין, ולכן העתקות דרך SSH לא מגיעות ללוח ההעתקה המקומי. במקום זאת עטפו את הפקודה המרוחקת: grok wrap ssh user@host מריץ אותה ב-PTY מקומי שתופס את OSC 52 וכותב ללוח ההעתקה שלכם. אותו דבר עובד עבור grok wrap docker exec ... ועבור grok wrap kubectl exec .... grok wrap הוא ניסיוני.

#צירופי מקשים לא עובדים

• WezTerm: הוסיפו config.enable_kitty_keyboard = true לקובץ wezterm.lua, ואז הפעילו מחדש. זה מתקן את Ctrl+Enter (interject) ואת Shift+Enter (שורה חדשה).
• הטרמינלים של VS Code, Cursor, Windsurf ו-Zed לא מבחינים בין Shift+Enter לבין Enter. לשורה חדשה השתמשו ב-Alt+Enter. אותו דבר חל על VS Code דרך SSH.
• Zellij תופס הרבה צירופי Ctrl. ב-Zellij 0.41 ומעלה, עברו ל-preset בשם "Unlock-First (non-colliding)" (Ctrl+O → c → Change Mode Behavior), ואז Ctrl+G משחרר זמנית את Zellij כשצריך אותו.
• Apple Terminal: Ctrl+O מבצע interject (אין בו את פרוטוקול המקלדת של Kitty בשביל Ctrl+Enter).

#אין מסך מלא, או גלילת העכבר נעצרת

גרוק רץ במכוון במצב מוטמע (inline) תחת Zellij ומצב הבקרה של tmux (tmux -CC). כפו מסך מלא עם alt_screen = "always" תחת [terminal] ב-~/.grok/pager.toml, או השביתו את זה בכל מקום עם --no-alt-screen.

אם פס הגלילה המקורי של הטרמינל משתלט, דיווח העכבר כבוי. ב-Apple Terminal מפעילים אותו מחדש תחת View → Allow Mouse Reporting (Cmd+R). ב-iTerm2 תחת Settings → Profiles → Terminal → "Enable mouse reporting".

עדיין תקועים? הריצו /feedback.