Skip to content

v1.2.0 — Which-Key HUD & Surround

Choose a tag to compare

@uhs-robert uhs-robert released this 18 Feb 05:22
· 317 commits to main since this release

What's New

🗺️ Which-Key HUD

A new eww-based which-key HUD displays available keybindings for the active submap.

  • Auto-shows when entering any transient submap
  • Press ? from any mode to manually toggle
  • Event-driven architecture with atomic render token system to prevent stale HUDs
  • Targeted skip support (--skip=TARGET) to suppress HUD for specific submaps
  • Multi-monitor aware — renders on the focused monitor
  • Auto-switches to multi-column layout when a single column would overflow
  • Opt-in: requires eww and socat, enable with $HYPRVIM_WHICH_KEY_ENABLED = 1 in settings.conf

🔁 Vim Surround

New surround operation to wrap text with bracket pairs or tags.

  • gs in NORMAL mode — surround word
  • S in VISUAL mode — surround selection
  • Supports (), {}, [], <>, quotes, and custom strings

⌨️ Scroll & Page Keybindings

Added Ctrl+d/Ctrl+u page scroll and related navigation bindings.


Fixes

  • Submap state lost on dismiss — preserve state when which-key is closed
  • Shift fallthrough in visual modes — prevent unintended mode exits
  • Blocking debounce removed — keypress monitor hardened

Upgrade Notes

  • Which-key is opt-in. Add $HYPRVIM_WHICH_KEY_ENABLED = 1 to your settings.conf to enable it.
  • Requires eww and socat for the which-key HUD feature.