folke /noice.nvim
💥 Highly experimental plugin that completely replaces the UI for messages, cmdline and the popupmenu.
★ 5,833⑂ 181👁 12⑃ 233● 708▤ 104
+0
日增长
5,833
stars
181
forks
12
watchers
233
prs
708
issues
104
releases
README
💥 Noice _(Nice, Noise, Notice)_
Highly experimental plugin that completely replaces the UI for messages, cmdline and the popupmenu.
!image
✨ Features
- 🌅 fully configurable views like nvim-notify,
splits, popups, virtual text, ..
- 🔍 use filters to route messages to different views
- 🌈 message highlights are preserved in the views (like the colors of :hi)
- 📝 command output like :messages
is shown in normal buffers, which makes it much easier to work with
- 📚 :Noice command to show a full message history
- ⌨️ no more :h more-prompt
- 💻 fully customizable cmdline with icons
- 💅 syntax highlighting for vim and lua on the cmdline
- 🚥 statusline components
- 🔭 open message history in telescope.nvim or fzf-lua
🔥 Status
Noice is using the new experimental vim.ui_attach API, so issues are to be expected.
It is highly recommended to use Neovim nightly, since a bunch of issues have already been fixed upstream.
Check this tracking issue for a list of known issues.
⚡️ Requirements
- Neovim = 0.9.0 _(nightly highly recommended)_
- nui.nvim: used for proper rendering and multiple views
- nvim-notify: notification view _(optional)_
- a Nerd Font _(optional)_
- nvim-treesitter _(optional, but highly recommended)_
used for highlighting the cmdline and lsp docs. Make sure to install the parsers for
vim, regex, lua, bash, markdown and markdown_inline
📦 Installation
Install the plugin with your preferred package manager:
lua
-- lazy.nvim
{
"folke/noice.nvim",
event = "VeryLazy",
opts = {
-- add any options here
},
dependencies = {
-- if you lazy-load any plugin below, make sure to add proper module="..." entries
"MunifTanjim/nui.nvim",
-- OPTIONAL:
-- nvim-notify is only needed, if you want to use the notification view.
-- If not available, we use mini as the fallback
"rcarriga/nvim-notify",
}
}
Suggested setup:
lua
require("noice").setup({
lsp = {
-- override markdown rendering so that cmp and other plugins use Treesitter
override = {
["vim.lsp.util.convert_input_to_markdown_lines"] = true,
["vim.lsp.util.stylize_markdown"] = true,
["cmp.entry.get_documentation"] = true, -- requires hrsh7th/nvim-cmp
},
},
-- you can enable a preset for easier configuration
presets = {
bottom_search = true, -- use a classic bottom cmdline for search
command_palette = true, -- position the cmdline and popupmenu together
long_message_to_split = true, -- long messages will be sent to a split
inc_rename = false, -- enables an input dialog for inc-rename.nvim
lsp_doc_border = false, -- add a border to hover docs and signature help
},
})
It's a good idea to run :checkhealth noice after installing to check for common issues.
vim-plug
vim
" vim-plug
call plugbegin()
Plug 'folke/noice.nvim'
Plug 'MunifTanjim/nui.nvim'
call plugend()
lua require("noice").setup()
⚙️ Configuration
noice.nvim comes with the following defaults:
Check the wiki for coTop issues
#6Known Issues Tracker17 comments · 2022-10-03#1201bug: Doesn't hide cmdline ("cmdheight = 0") with ui213 comments · 2026-04-07#1232bug: Hover with an empty fenced code block throws `vim/treesitter/_range.lua:212: Index out of bounds`0 comments · 2026-11-05
Discussions
#1224How do I make sure previous contents of cmdline message are hidden?2 comments · 2026-07-11#1221[BUG] Neovide + noice.nvim: `vim.api.nvim_list_uis()` early vs late returns inconsistent `ext_cmdline/ext_messages`0 comments · 2026-06-25#1210I'm having trouble setting up a working vim.opt.confirm popup0 comments · 2026-04-24#1208command output to buffer feature plugins0 comments · 2026-04-22#1203How to disable unnecessary input popup1 comments · 2026-04-09#1199Disable popup for vim.lsp.buf.rename1 comments · 2026-04-05#1190mini.completion interfering with popupmenu0 comments · 2026-02-04#1180How to get the popup into bottom right?1 comments · 2025-12-09
Latest release
v4.10.0 v4.10.0 2025-02-064.10.0 (2025-02-06) Features fzf: fix fzf integration (1048) (f3291db) Bug Fixes cmdline: use number indexed vim.g.ui_cmdline_pos (eaed6cc) confirm: fixed vim.fn.confirm on nightly (0.11). Closes 1036 (00b5984) fzf-lua: update update_title and update_scrollbar to update_preview_title and update_preview_scrollbar (1034) (5530d78), closes 1029 nui: don't error when border win was closed. Fixes 832 (d2b092a) telescope: handle hl_group ID correctly in picker (1032) (002b202), closes 1024