CLI

终端支持

Grok 使用终端转义序列来绘制其界面，用于颜色、剪贴板、鼠标和全屏控制，而某些终端、多路复用器和 SSH 会话对这些序列的处理方式不同。在 Grok 中运行 /terminal-setup（别名有 /terminal-check、/terminal-info）可以查看检测到的内容、活动的剪贴板路由以及任何问题及修复方法。

颜色显示不正确

在您的 shell 配置文件中设置 COLORTERM=truecolor。在 tmux 内部，还需要启用 24 位 RGB：

# ~/.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 重新加载。

复制无法到达我的剪贴板

Grok 写入原生操作系统剪贴板，在 tmux 内部写入 tmux 粘贴缓冲区，并在远程情况下（SSH、容器、Linux）发出 OSC 52。两个常见障碍：

• iTerm2 会忽略 OSC 52，直到您启用"设置 → 常规 → 选择 →"终端中的应用程序可以访问剪贴板"。
• Apple Terminal 完全忽略 OSC 52，因此通过 SSH 的复制无法到达您的本地剪贴板。请改用包装远程命令：grok wrap ssh user@host 在本地 PTY 中运行它，该 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 进行换行。通过 SSH 使用 VS Code 时同样适用。
• Zellij 会拦截许多 Ctrl 组合键。在 Zellij 0.41+ 上，切换到"解锁优先（无冲突）"预设（Ctrl+O → c → 更改模式行为），然后 Ctrl+G 会在需要时临时解锁 Zellij。
• Apple Terminal：Ctrl+O 用于插入（它缺少用于 Ctrl+Enter 的 Kitty 键盘协议）。

没有全屏，或鼠标滚动停止

Grok 有意在 Zellij 和 tmux 控制模式下（tmux -CC）内联运行；在 ~/.grok/pager.toml 的 [terminal] 下使用 alt_screen = "always" 强制全屏，或使用 --no-alt-screen 在任何地方禁用它。

如果终端的原生滚动条接管了控制，则鼠标报告处于关闭状态：Apple Terminal 在"视图 → 允许鼠标报告"（Cmd+R）下重新启用；iTerm2 在"设置 → 配置文件 → 终端 → "启用鼠标报告"下重新启用。

仍然卡住了？运行 /feedback。