Major update for which-key.nvim! This release includes a complete rewrite and several new features. which-key was my very first plugin, so it was time for a fresh start. 🎉
- ✨ Full Rewrite: Improved performance and functionality.
- 👀 Visual & Operator Pending Mode Integration: Now uses
ModeChanged
, eliminating the need for operator remappings. - 🔧 Simplified Mappings: Removed obscure secret mappings.
- 🔒 Safer Auto Triggers: Auto triggers are now never created for single keys apart from
g
andz
. All other letters are unsafe. - ⏱️ Delay: Set delay independently of
timeoutlen
. - 🛠️ Layout:
- Presets:
classic
,modern
, andhelix
. - Enable/disable which-key for specific modes.
- Configurable sorting with options like
local
,order
,group
,alphanum
,mod
,lower
,icase
,desc
, andmanual
. - Expand groups with fewer keymaps.
- Customizable string replacements for
key
anddesc
.
- Presets:
- 🎨 Icon Support:
- Auto-detect icons for keymaps using
lazy.nvim
. - Custom icon rules and specifications for mapping levels.
- Auto-detect icons for keymaps using
- 🚫 Never Get in the Way: Avoids overlapping with the cursor.
- 🗂️ New Mapping Spec: New and better mappings spec, more in line with
vim.keymap.set
and how you define keymaps with lazy.nvim - 🐛 New Bugs: Lots of new and exciting bugs to discover! 🐞
For detailed configuration and usage instructions, refer to the updated README.