+3
Daily
9,489
stars
440
forks
39
watchers
424
prs
1,367
issues
2
releases
README
nvim-cmp
A completion engine plugin for neovim written in Lua.
Completion sources are installed from external repositories and "sourced".
https://github.com/hrsh7th/nvim-cmp/assets/22756295/afa70011-9121-4e42-aedd-0153b630eeab
Readme!
====================
1. There is a GitHub issue that documents breaking changes for nvim-cmp. Subscribe to the issue to be notified of upcoming breaking changes.
2. This is my hobby project. You can support me via GitHub sponsors.
3. Bug reports are welcome, but don't expect a fix unless you provide minimal configuration and steps to reproduce your issue.
4. The cmp.mapping.preset. is pre-defined configuration that aims to mimic neovim's native like behavior. It can be changed without announcement. Please manage key-mapping by yourself.
Concept
====================
- Full support for LSP completion related capabilities
- Powerful customizability via Lua functions
- Smart handling of key mappings
- No flicker
Setup
====================
Recommended Configuration
This example configuration uses vim-plug as the plugin manager and vim-vsnip as a snippet plugin.
vim
call plugbegin(s:plug_dir)
Plug 'neovim/nvim-lspconfig'
Plug 'hrsh7th/cmp-nvim-lsp'
Plug 'hrsh7th/cmp-buffer'
Plug 'hrsh7th/cmp-path'
Plug 'hrsh7th/cmp-cmdline'
Plug 'hrsh7th/nvim-cmp'
" For vsnip users.
Plug 'hrsh7th/cmp-vsnip'
Plug 'hrsh7th/vim-vsnip'
" For luasnip users.
" Plug 'L3MON4D3/LuaSnip'
" Plug 'saadparwaiz1/cmp_luasnip'
" For mini.snippets users.
" Plug 'echasnovski/mini.snippets'
" Plug 'abeldekat/cmp-mini-snippets'
" For ultisnips users.
" Plug 'SirVer/ultisnips'
" Plug 'quangnguyen30192/cmp-nvim-ultisnips'
" For snippy users.
" Plug 'dcampos/nvim-snippy'
" Plug 'dcampos/cmp-snippy'
call plugend()
lua '] = cmp.mapping.scroll_docs(-4),
[''] = cmp.mapping.scroll_docs(4),
[''] = cmp.mapping.complete(),
[''] = cmp.mapping.abort(),
[''] = cmp.mapping.confirm({ select = true }), -- Accept currently selected item. Set select to false to only confirm explicitly selected items.
}),
sources = cmp.config.sources({
{ name = 'nvim_lsp' },
{ name = 'vsnip' }, -- For vsnip users.
-- { name = 'luasnip' }, -- For luasnip users.
-- { name = 'ultisnips' }, -- For ultisnips users.
-- { name = 'snippy' }, -- For snippy users.
}, {
{ name = 'buffer' },
})
})
-- To use git you need to install the plugin petertriho/cmp-git and uncomment lines below
-- Set configuration for specific filetype.
--[[ cmp.setup.filetype('gitcommit', {
sources = cmp.config.sources({
{ name = 'git' },
}, {
{ name = 'buffer' },
})
})
require("cmp_git").setup() ]]--
-- Use buffer source for / and ? (if you enabled native_menu, this won't work anymore).
cmp.setup.cmdline({ '/', '?' }, {
mapping = cmp.mapping.preset.cmdline(),
sources = {
{ name = 'buffer' }
}
})
-- Use cmdline & path source for ':' (if you enabled native_menu, this won't woTop issues
#1877Parsing error: Error 08:05:18 notify.error ...local/share/nvim/lazy/nvim-cmp/lua/cmp/utils/snippet.lua:411: snippet parsing failed.32 comments · 2024-04-09#309Terminal title flickers when completion menu opens31 comments · 2021-10-09#908allow wild menu to be above statusline27 comments · 2022-04-16#148[Feature] Slow sources benchmark and timeout27 comments · 2021-09-04#1219Question: Completion in nvim's terminal window26 comments · 2022-10-07#511Feature Request: Dedup items26 comments · 2021-11-11#1716cmp.ConfirmBehavior.MatchSuffix?23 comments · 2023-10-01#1326Manual whole-line completion with ^X^L inserts the wrong entry into the buffer.20 comments · 2022-11-25
Discussions
#2216How can I customize when nvim‑cmp triggers completion?0 comments · 2026-02-22#2213How to show on cmp_doc and cmp_menu in a vertical way.1 comments · 2026-01-27#2201java.util documentation for completion incomplete1 comments · 2025-11-11#2197How do i set my keybinds?1 comments · 2025-10-22#2191`select_next_item` complete parenthesis and arguements?0 comments · 2025-09-19#2189CMP Menu Customization1 comments · 2025-09-08#2176Let `ConfirmBehavior.Insert` insert the same as `cmp.ConfirmBehavior.Insert`0 comments · 2025-06-18#2168near_cursor inverts UP and DOWN keys. Is this expected?0 comments · 2025-05-10
Latest release
v0.0.2 v0.0.2 2025-01-07this is new version of nvim-cmp for some of the plugin managers.