BUILD / toggle-mouse-reporting-in-grok-build

Build

Toggle mouse reporting in Grok Build scrollback

Toggle mouse reporting in Grok Build scrollback

mouse_reporting_toggle under [ui] lets Ctrl+R in scrollback turn terminal mouse capture on or off. Default is off. Official: Settings reference.

Enable the shortcut

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

[ui]
mouse_reporting_toggle = true

Process override:

export GROK_MOUSE_REPORTING_TOGGLE=1

Use false / 0 to disable the Ctrl+R toggle.

When it helps

Terminal mouse capture can steal clicks you meant for the host terminal (selection, paste, pane focus). With the toggle on, press Ctrl+R while focused in scrollback to flip capture for that moment, then flip it back.

Related clipboard and SSH tips

Clipboard over SSH: Copy clipboard over SSH with grok wrap. Scroll speed: Tune scroll speed in Grok Build. The ssh_wrap contextual hint can point at grok wrap when SSH lacks a clipboard sink — Control contextual hints.

Pitfalls

  • Putting [ui] in project .grok/config.toml — user config only.
  • Expecting Ctrl+R to work while the key is still false — enable mouse_reporting_toggle first.