BUILD / tune-scroll-speed-in-grok-build

Build

Tune scroll speed in Grok Build

Tune scroll speed in Grok Build

Mouse and trackpad scroll in the TUI are controlled under [ui]: speed, input mode, lines per tick, and invert. Official: Settings reference.

Config

User config (~/.grok/config.toml or $GROK_HOME/config.toml):

[ui]
scroll_speed = 50
scroll_mode = "auto"
scroll_lines = 3
invert_scroll = false
Setting Values / default Role
scroll_speed 1100 (default 50) Multiplier for mouse/trackpad scroll
scroll_mode auto (default), wheel, trackpad How scroll input is interpreted
scroll_lines 110 (unset → terminal profile) Lines per scroll tick
invert_scroll true / false (default false) Reverse vertical direction

Raise scroll_speed toward 100 for faster passes through long tool output; drop it when one flick jumps past the hunk you needed. Set scroll_mode to wheel or trackpad if auto mis-reads your device.

Environment overrides

GROK_SCROLL_SPEED=80
GROK_SCROLL_MODE=trackpad
GROK_SCROLL_LINES=5
GROK_INVERT_SCROLL=0

Unset GROK_SCROLL_LINES to fall back to config / terminal profile.

Related controls

  • Jump by search instead of scrolling: Search scrollback with /find in Grok Build.
  • Match stream cadence to the display: [ui.display_refresh] auto_cadence_enabled (restart required) — see the settings reference.

Pitfalls

  • Putting [ui] scroll keys in project .grok/config.toml — they belong in user config only.
  • Expecting invert_scroll to flip horizontal panes — it reverses vertical scroll only.