BUILD / check-terminal-setup-in-grok-build

Build

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

  1. Open a Grok Build TUI session.
  2. Type /terminal-setup (or /terminal-check / /terminal-info) and send.
  3. 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+Oc → 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.