v1.2.3

New Features

• Live register contents in which-key HUD: The GET-REGISTER submap now shows live previews of all named, numbered, default, yank, and search registers (truncated to 40 chars).
• Stale-close watchdog for which-key render: A 40ms watchdog closes a stale HUD if the render token has advanced and the window has not changed, eliminating wrong-submap flashes.

Bug Fixes

• Fixed which-key HUD disappearing during rapid submap transitions. Replaced PID-based cancellation with a token-based self-cancellation model; added a retry loop for empty binds, focused-monitor caching, and earlier token validation.
• Removed which-key trigger from mark operations (M, Ctrl+M, ', `); which-key is now limited to operator-pending submaps only.
• Which-key show delay is now applied only to operator-pending submaps (D-MOTION, C-MOTION, Y-MOTION, G-MOTION, R-CHAR); all other submaps show instantly.

v1.2.2

v1.2.2 — 2026-02-18

New Features

• Instant which-key for mark submaps: The which-key HUD now appears immediately (no delay) when entering mark-related submaps, since they are transient and benefit from instant feedback.

Bug Fixes

• Stale marks are now auto-deleted when their target window is closed, preventing jumps to dead windows.
• The which-key HUD is now auto-hidden when a new window opens, avoiding a stale overlay on window changes.
• Which-key binding is now placed before the catchall in all submaps, fixing cases where the trigger was swallowed.
• Fixed which-key rendering for mark submaps.

Improvements

• Which-key trigger changed from ? to SPACE across all submaps for faster, more natural access.

v1.2.1

Bug Fixes

• Count is now correctly preserved through D, C and Y operators and cleared on cancel or sub-entry exit, preventing count leakage across operations.

Improvements

• Which-key show delay increased to 200ms for a less intrusive feel.
• Theme system simplified with generic variables and auto-apply, reducing duplication across palette definitions.
• Add NEWS.md to show latest features since last update.

New Features

• Which-key SCSS overrides: Users can now drop a whichkey.scss into the config dir to customize the HUD appearance without touching upstream styles.

Full Changelog: v1.2.0...v1.2.1

v1.2.0 — Which-Key HUD & Surround

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.

HyprVim v1.1.0

New Features

• Insert mode editor binding available in all modes
• Insert mode option for open-editor command
• Smart 0 handling in VISUAL mode for counts
• Jump to line start after paragraph motions ({, })
• Expanded command mode with comprehensive window/workspace management
• System control commands in command mode (shutdown, reboot, etc.)
• Configurable submap transitions after command mode
• Consolidated mark submaps using state-based transitions
• Mark viewing (gm) and deletion (dm + backspace) commands

Improvements

• Extract state management utilities to shared library for better code reuse
• Reorganize wl-kbptr cursor submap keybindings
• Standardize $HYPRVIM_ prefix for all variable naming
• Change command mode keybinding to shift+semicolon

Bug Fixes

• Pass HYPRVIM_LOCK to command script properly
• Hide cursor when exiting cursor submap

Documentation

• Improve extras links formatting and add references
• Streamline README with wiki integration
• Expand operator mode documentation
• Add HyprVim script examples to hyprland-basics
• Various formatting and organization improvements

See README.md and the wiki for full documentation.

Full Changelog: v1.0.0...v1.1.0

HyprVim v1.0.0 - Initial Release

HyprVim

A comprehensive vim-style navigation and text editing system for Hyprland.

Features:

• Complete vim modes (NORMAL, VISUAL, V-LINE, INSERT, COMMAND)
• Motions with count support (hjkl, w/b/e, gg/G, etc.)
• Operators with text objects (d, c, y + iw, aw, ip, ap)
• Register system for multi-clipboard management
• Mark system for cross-workspace navigation
• Command mode (:w, :q, :qa, :%s, etc.)
• Find operations (/, ?, f, F, t, T, *, #, n, N)
• Replace operations (r, R)
• Full editor integration (open nvim/vim for complex edits)
• Comprehensive help system (gh)
• Optional extras for enhanced functionality

See README.md for full documentation and installation instructions.

Full Changelog: https://github.com/uhs-robert/hyprvim/commits/v1.0.0