legendary.nvim
A Neovim plugin that defines keymaps, commands, and autocmds as Lua tables while building a searchable legend like VS Code's Command Palette.
What is legendary.nvim?
legendary.nvim is a Neovim plugin that serves as a centralized legend and manager for keymaps, commands, autocmds, and Lua functions. It solves the problem of forgotten or hard-to-discover Vim actions by providing a searchable interface similar to VS Code's Command Palette, where users can define all actions as structured Lua tables and quickly find and execute them.
Neovim users who manage complex configurations, especially those using Lua for setup and seeking improved discoverability of their custom keymaps and commands. It's ideal for developers who use plugins like lazy.nvim or which-key.nvim and want a unified command palette.
Developers choose legendary.nvim because it combines action definition with discoverability, eliminating the need to memorize countless keybindings. Its deep integrations with popular Neovim ecosystems and frecency-based sorting make it a powerful productivity booster for advanced Vim workflows.
Overview
🗺️ A legend for your keymaps, commands, and autocmds, integrates with which-key.nvim, lazy.nvim, and more.
Use Cases
Best For
- Centralizing and searching custom Neovim keymaps and commands
- Integrating keymaps from lazy.nvim plugin specifications automatically
- Creating a VS Code-like command palette in Neovim
- Managing buffer-specific actions without clutter
- Converting legacy Vimscript keymaps to Lua configurations
- Improving workflow with frequently-used action prioritization
Not Ideal For
- Users who prefer minimal, dependency-free Neovim setups without additional databases or UI plugins
- Teams with extensive Vimscript-based configurations unwilling to migrate to Lua table definitions
- Developers already satisfied with which-key.nvim for keymap hints and don't need a full command palette
- Environments where sqlite library access is restricted or problematic, breaking frecency sorting
Pros & Cons
Pros
Centralizes keymaps, commands, autocmds, and functions as declarative Lua tables, integrating with lazy.nvim and which-key.nvim to reduce configuration duplication and improve organization.
Automatically loads keymaps from lazy.nvim plugin specs and uses which-key.nvim tables, creating a seamless workflow without manual binding for popular Neovim ecosystems.
Provides a VS Code-like command palette via vim.ui.select() with fuzzy finder support, plus frecency sorting to prioritize recently and frequently used actions, enhancing productivity.
Filters actions to show only relevant keymaps and commands for the current buffer, reducing clutter and improving focus during specific editing tasks.
Cons
The project is actively seeking a new maintainer, as noted in the README, which risks stalled development, breaking changes, or lack of future support.
Requires additional plugins like dressing.nvim for UI and sqlite.lua for frecency sorting, with troubleshooting needed for sqlite library paths on some systems, adding configuration overhead.
Forces users to define all actions in Lua tables rather than traditional Vimscript, which can be a barrier for those unfamiliar with Lua or with legacy Vimscript setups.
Open Source Alternative To
legendary.nvim is an open-source alternative to the following products:
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.
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
nvim-recorderEnhance the usage of macros in Neovim.
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.