Check terminal setup in Grok Build
Check terminal setup in Grok Build
/terminal-setup (aliases /terminal-check, /terminal-info) shows what Grok detected, which clipboard routes are active, and any issues with fixes. Official: Terminal Support and Modes and Commands.
Run the check
- Open a Grok Build TUI session.
- Type
/terminal-setup(or/terminal-check//terminal-info) and send. - Read the detection summary, clipboard routes, and listed issues.
Apply the matching fix
| Issue | Fix |
|---|---|
| Colors look wrong | Set COLORTERM=truecolor. In tmux also enable 24-bit RGB (default-terminal "tmux-256color", terminal-features ",*:RGB"), plus set-clipboard on and allow-passthrough on, then tmux source-file ~/.tmux.conf |
| iTerm2 ignores OSC 52 | Settings → General → Selection → enable “Applications in terminal may access clipboard” |
| Apple Terminal over SSH | Apple Terminal ignores OSC 52; wrap the remote command with grok wrap — see Copy clipboard over SSH with grok wrap |
| WezTerm chords | Add config.enable_kitty_keyboard = true to wezterm.lua, then restart (Ctrl+Enter interject, Shift+Enter newline) |
| VS Code / Cursor / Windsurf / Zed | Use Alt+Enter for newlines (Shift+Enter is not distinguished from Enter) |
| Zellij Ctrl chords | On Zellij 0.41+, switch to Unlock-First (non-colliding) (Ctrl+O → c → Change Mode Behavior); Ctrl+G unlocks temporarily |
| Mouse / scrollbar takeover | Apple Terminal: View → Allow Mouse Reporting (Cmd+R). iTerm2: Settings → Profiles → Terminal → Enable mouse reporting |
Still stuck after the listed fixes? Run /feedback.
Pitfalls
- Chasing clipboard over SSH inside Apple Terminal without
grok wrap— OSC 52 never reaches the local clipboard there. - Editing tmux color settings without reloading (
tmux source-file ~/.tmux.conf). - Duplicating the full wrap how-to here — keep wrap details on the dedicated post linked above.