nap.nvim
A lightweight Neovim plugin for quick navigation between buffers, tabs, files, diagnostics, and other items using single-key repeats.
What is nap.nvim?
nap.nvim is a Neovim plugin that enables rapid navigation between various editor elements like buffers, tabs, files, diagnostics, and quickfix entries. It solves the problem of cumbersome multi-key navigation by allowing users to jump initially with a prefix key and then cycle with a single repeat key, streamlining movement within Neovim.
Neovim users, particularly developers and power users who frequently switch between buffers, tabs, or navigate diagnostics and quickfix lists, and seek to optimize their editing workflow with fewer keystrokes.
Developers choose nap.nvim for its lightweight, navigation-focused design that reduces keystrokes compared to default Vim motions or plugins like unimpaired.vim, its extensibility via Lua, and seamless integration with popular Neovim plugins.
Overview
Quickly move between next and previous NeoVim buffer, tab, file, quickfix, diagnostic, etc.
Use Cases
Best For
- Reducing keystrokes when cycling through open buffers or tabs
- Quickly navigating diagnostic messages from LSP or linters
- Efficiently moving through quickfix and location list results
- Jumping between files in a project or recent edit history
- Navigating folds, tags, or spell errors with consistent keybindings
- Extending navigation support for plugins like Gitsigns or Aerial
Not Ideal For
- Users who rely heavily on mouse-driven or GUI-based navigation workflows
- Developers seeking all-in-one plugins that combine navigation with editing, window management, or other features
- Teams with highly customized keybinding setups where adding new mappings could cause conflicts
- Projects where navigation is infrequent or sufficiently handled by built-in Neovim commands or other minimalist plugins
Pros & Cons
Pros
After an initial jump with a prefix key, cycling through items uses single repeat keys like <c-n>, cutting keystrokes significantly compared to standard two-key combinations.
Supports navigation across buffers, tabs, files, diagnostics, quickfix/location lists, and more with consistent ]/[ mappings, reducing the need to memorize disparate commands.
Allows adding or overriding operators with a simple API, including helper functions for plugins like Gitsigns and Aerial, making it adaptable to various workflows.
Dedicated solely to navigation tasks without bloat from editing features, ensuring minimal performance overhead and a clean scope.
Cons
Choosing optimal prefix and repeat keys requires trial and error, and the README admits issues like timeout delays if prefix and repeat keys are identical.
Focuses only on navigation, lacking editing or option-toggling commands found in similar plugins like unimpaired.vim, which might necessitate additional plugins.
While extensible, integrating with external plugins like Gitsigns requires extra setup, and conflicts with other keymap-heavy plugins can arise.
Frequently Asked Questions
Related Projects
leap.nvimNeovim's answer to the mouse 🦘
flash.nvimNavigate your code with search labels, enhanced character motions and Treesitter integration
lightspeed.nvimdeprecated in favor of leap.nvim
precognition.nvim💭👀precognition.nvim - Precognition uses virtual text and gutter signs to show available motions.
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.