which-key.nvim
💥 Create key bindings that stick. WhichKey helps you remember your Neovim keymaps, by showing available keybindings in a popup as you type.
WhichKey is a Neovim plugin that shows a popup listing all your keyboard shortcuts as you type them, so you can discover and remember your keybindings without ever forgetting what a key sequence does.
WhichKey is a plugin for Neovim, a keyboard-driven text editor popular among developers. The plugin solves a common problem: Neovim can have hundreds of custom keyboard shortcuts, and it is easy to forget what you have set up. WhichKey watches your key presses and shows a small popup listing all the shortcuts that start with whatever keys you have typed so far.
The popup works in multiple editing modes, including normal, insert, visual, operator-pending, terminal, and command mode. Each mode can be enabled or disabled independently. You can customize when the popup appears by adjusting a delay setting that operates separately from Neovim's built-in timeout behavior. The plugin also ships with several optional panels for viewing your active marks, registers, and spelling suggestions.
Layout and appearance are configurable. Three preset styles are included: classic, modern, and helix. If those do not fit your setup, you can adjust the window dimensions, padding, and position manually. The plugin can display icons next to shortcuts, pulling them from optional icon libraries if you have those installed, and it supports a Nerd Font for icon rendering.
WhichKey lets you add descriptions to your shortcuts so the popup shows human-readable labels rather than raw command strings. You can sort the entries by different criteria, such as alphabetical order, local versus global mappings, or the order they were added. A hydra mode keeps the popup open until you press Escape, which is useful when you want to browse available shortcuts without triggering one by accident.
The plugin requires Neovim version 0.9.4 or newer. Icons require an optional icon library and a Nerd Font on your system, but neither is mandatory. Installation is handled through any standard Neovim package manager.
Where it fits
- Install WhichKey to get an on-screen guide to all Neovim shortcuts so you stop forgetting your keybindings.
- Add human-readable descriptions to existing Neovim key mappings so the popup shows labels instead of raw command strings.
- Use hydra mode to browse all available shortcuts interactively without accidentally triggering one.
- Enable the marks and registers panels to quickly view your active bookmarks and clipboard contents inside Neovim.