hawtkeys.nvim
A Neovim plugin that suggests memorable and ergonomic keymaps while analyzing your current configuration for issues.
What is hawtkeys.nvim?
hawtkeys.nvim is a Neovim plugin that analyzes your current keybindings and suggests new, ergonomic shortcuts. It solves the problem of choosing effective keymaps by considering keyboard layout, finger comfort, and memorability while avoiding conflicts.
Neovim users who want to optimize their keyboard shortcuts for efficiency and comfort, particularly those with complex configurations or multiple plugins.
Developers choose hawtkeys.nvim because it provides data-driven suggestions tailored to their setup, helps debug mapping conflicts, and supports various configuration methods out of the box.
Overview
⌨️🔥 Suggest new easy to hit keymaps and find issues with your current key map configurations
Use Cases
Best For
- Finding ergonomic keybindings for new commands in Neovim
- Debugging why certain Neovim keymaps are not working
- Auditing and cleaning up a large Neovim configuration file
- Optimizing keyboard shortcuts for specific layouts like Colemak or Dvorak
- Ensuring consistent keymap patterns across multiple plugins
- Learning effective keybinding strategies through suggestions
Not Ideal For
- Vim users who have no plans to switch to Neovim, as the plugin is Neovim-specific and won't work in Vim.
- Teams with strictly enforced, non-negotiable keybinding standards that leave no room for automated suggestions or changes.
- Users with extremely simple Neovim configurations (e.g., fewer than a dozen keymaps) where analysis and optimization provide minimal benefit.
- Projects requiring real-time, interactive keymap editing without command-line interfaces, as hawtkeys.nvim operates via Neovim commands and static analysis.
Pros & Cons
Pros
Recommends keybindings based on keyboard layout, finger comfort, and memorability, excluding already used combinations to avoid conflicts, as shown in the smart scoring system.
Scans all Neovim keymaps and config files to display existing mappings via :HawtkeysAll, helping users audit and understand their current setup thoroughly.
Identifies conflicting keybindings with :HawtkeysDupes, which aids in debugging plugin malfunctions caused by accidental overrides.
Allows adjustment of leader key, homerow, power fingers, and keyboard layout in the config, enabling personalized ergonomic tailoring beyond defaults.
Cons
The README admits that 'installation instructions to follow,' relying on users' existing package manager knowledge, which can be a barrier for newcomers or those unfamiliar with Neovim plugin ecosystems.
Configuring customMaps for non-standard keybinding methods (e.g., which-key or lazy.nvim) requires specifying precise indices and methods, making setup error-prone and time-consuming.
Only supports four keyboard layouts (qwerty, colemak, colemak-dh, dvorak), and adding new ones requires community contributions via pull requests, limiting immediate usability for users with niche layouts.
Frequently Asked Questions
Related Projects
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.
legendary.nvim🗺️ A legend for your keymaps, commands, and autocmds, integrates with which-key.nvim, lazy.nvim, and more.
better-escape.nvimMap keys without delay when typing
commander.nvimCreate and manage keybindings and commands in a more organized manner, and search them quickly through Telescope
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.