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
/themeandtheme = "auto"apply without a restart; some other UI keys (for example display-refresh auto cadence) still need a restart per the settings reference.