Features

Theming

Run /theme (alias /t) to open the theme picker with a live preview, /theme <name> to switch directly, or set it in ~/.grok/config.toml:

TOML

[ui]
theme = "tokyonight"

Built-in themes

ThemeNamesTruecolor required
GrokNight (default)groknight, darkNo
GrokDaygrokday, light, dayNo
TokyoNighttokyonight, tokyoYes
RosePineMoonrosepine, rose-pine-moonYes
OscuraMidnightoscura, oscura-midnightYes

On terminals without truecolor, themes are quantized to the available palette and the picker hides the truecolor-only entries. If colors look wrong, see Terminal Support.

Following 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 overridden:

TOML

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

For a denser layout, /compact-mode reduces padding and persists the choice. Finer appearance controls (scrollback layout, block styling, animations) live in ~/.grok/pager.toml.


Last updated: July 2, 2026