nvim-cmp
A completion engine plugin for Neovim written in Lua that supports LSP and multiple snippet engines.
What is nvim-cmp?
nvim-cmp is a completion engine plugin for Neovim written in Lua. It provides intelligent code completion by integrating with the Language Server Protocol (LSP) and various snippet engines, enhancing the development workflow within Neovim. It is designed to be highly customizable while maintaining performance and a native-like feel.
Neovim users, particularly developers who want a powerful, extensible, and configurable code completion system integrated with LSP and snippet engines.
Developers choose nvim-cmp for its full LSP completion support, extensive customizability via Lua, and smooth, flicker-free experience. Its unique selling point is the ability to mix and match completion sources from external repositories, allowing a tailored setup.
Overview
A completion plugin for neovim coded in Lua.
Use Cases
Best For
- Setting up intelligent code completion in Neovim with LSP integration.
- Creating a highly customizable completion workflow using Lua configuration.
- Integrating multiple snippet engines like vsnip, luasnip, ultisnips, snippy, or mini.snippets.
- Building a completion system that supports various sources such as buffer, path, cmdline, and git.
- Achieving a native-like, flicker-free completion experience in Neovim.
- Managing complex key mappings for completion with preset configurations.
Not Ideal For
- Vim users or those not using Neovim, as it relies on Neovim-specific Lua APIs and features.
- Developers who want a completion plugin that works immediately after installation without any Lua configuration or dependency management.
- Teams requiring long-term stability without breaking changes, given the documented breaking changes in issue #231.
- Users who need guaranteed professional support and prompt bug fixes, as the author notes it's a hobby project with limited guarantees.
Pros & Cons
Pros
Supports all LSP completion capabilities, enabling seamless integration with language servers for intelligent code suggestions, as highlighted in the key features.
Completion sources are installed from external repositories, allowing users to mix and match sources like buffer, path, and cmdline, with a wiki listing numerous options.
Offers powerful configuration through Lua functions, providing fine-grained control over behavior and appearance, demonstrated in the extensive setup example.
Compatible with various snippet engines like vsnip, luasnip, and ultisnips, giving flexibility in snippet management, as shown in the configuration snippets.
Cons
The project documents breaking changes in issue #231, requiring users to stay updated and potentially adjust configurations, which can disrupt workflows.
Requires installing multiple plugins and writing Lua configuration, which can be daunting for users not familiar with Neovim's ecosystem or Lua programming.
Bug fixes are not guaranteed without minimal reproduction steps, and support might be inconsistent, as the author explicitly states it's a hobby project.
Frequently Asked Questions
Related Projects
nvim-mini/mini.nvim#mini.completionLibrary of 40+ independent Lua modules improving Neovim experience with minimal effort
blink.cmpPerformant, batteries-included completion plugin for Neovim
copilot.luaFully featured & enhanced replacement for copilot.vim complete with API for interacting with Github Copilot
coq_nvimFast as FUCK nvim completion. SQLite, concurrent scheduler, hundreds of hours of optimization.
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.