📘 תיעוד 3

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

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

#הצבעים נראים שגויים

הגדירו COLORTERM=truecolor בפרופיל המעטפת שלכם. בתוך 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

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

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

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

• 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 (שליחה עכשיו) ואת Shift+Enter (שורה חדשה).
• הטרמינלים של VS Code, Cursor, Windsurf ו-Zed לא יכולים להבדיל בין Shift+Enter ל-Enter. השתמשו ב-Alt+Enter לשורות חדשות. אותו דבר חל על VS Code דרך SSH.
• Zellij מיירט צירופי Ctrl רבים. ב-Zellij 0.41 ומעלה, עברו לערכה הקבועה "Unlock-First (non-colliding)" (Ctrl+O → c → Change Mode Behavior), ואז Ctrl+G משחרר זמנית את Zellij כשצריך אותו.
• ל-Apple Terminal אין את פרוטוקול המקלדת Kitty, ולכן הוא לא יכול לשלוח את Ctrl+Enter או Ctrl+I כמקשים נפרדים. לצירוף השליחה עכשיו שלו, ראו הבדלי טרמינל.

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

גרוק רץ בכוונה בתוך השורה תחת 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.