BUILD / change-theme-in-grok-build

Build

Change the theme in Grok Build

Change the theme in Grok Build

Grok Build themes live in the TUI. Run /theme (alias /t) for a live preview picker, /theme <name> to switch directly, or set the value in ~/.grok/config.toml.

[ui]
theme = "tokyonight"

Built-in themes

Theme Names Truecolor required
GrokNight (default) groknight, dark No
GrokDay grokday, light, day No
TokyoNight tokyonight, tokyo Yes
RosePineMoon rosepine, rose-pine-moon Yes
OscuraMidnight oscura, oscura-midnight Yes

On terminals without truecolor, themes are quantized to the available palette and the picker hides truecolor-only entries. If colors look wrong after a switch, fix the terminal first: Fix Grok Build terminal colors, clipboard, and keys.

Follow the system appearance

Set theme = "auto" (alias "system") to track your OS light/dark setting. Changes apply within seconds, without a restart. Dark maps to GrokNight and light to GrokDay unless you override:

[ui]
theme = "auto"
auto_dark_theme = "tokyonight"
auto_light_theme = "grokday"

Environment override: GROK_THEME (same idea as the [ui] theme key). See the settings reference.

Denser layout

/compact-mode reduces padding and persists the choice ([ui] compact_mode in config). Finer appearance controls (scrollback layout, block styling, animations) live in ~/.grok/pager.toml.

Pitfalls

  • TokyoNight, RosePineMoon, and OscuraMidnight need a truecolor terminal; without it the picker hides them and the palette quantizes.
  • Theme changes from /theme and theme = "auto" apply without a restart; some other UI keys (for example display-refresh auto cadence) still need a restart per the settings reference.