+4
Daily
9,652
stars
320
forks
28
watchers
344
prs
1,504
issues
18
releases
README
All-in-one plugin
Library of 45+ independent Lua modules improving overall Neovim (version 0.10 and higher) experience with minimal effort. They all share same configuration approaches and general design principles.
Think about this project as "Swiss Army knife" among Neovim plugins: it has many different independent tools (modules) suitable for most common tasks. Each module can be used separately without any startup and usage overhead.
If you want to help this project grow but don't know where to start:
- Leave a star for 'mini.nvim' (on any supported code forge) and/or any other MINI projects.
- Check out contributing guides.
See change log for a history of changes, including current development version.
See MiniMax for a full config example based on 'mini.nvim'.
[!NOTE]
This was previously hosted at echasnovski/mini.nvim. It was transferred to a dedicated organization to improve long term project stability. See more details here.
Table of contents
- Installation
- Modules
- General principles
- Plugin color schemes
- Planned modules
Installation
This project is hosted on several code forges (use preferred link in the installation code snippet):
- https://github.com/nvim-mini/mini.nvim (main)
- https://tangled.org/nvim-mini.org/mini.nvim (mirror)
- https://codeberg.org/nvim-mini/mini.nvim (mirror)
There are two branches to install from:
- main (default, recommended) will have latest development version of plugin. All changes since last stable release should be perceived as being in beta testing phase (meaning they already passed alpha-testing and are moderately settled).
- stable will be updated only upon releases with code tested during public beta-testing phase in main branch.
Here are code snippets for some common installation methods:
- (Recommended) With vim.pack (on Neovim 0.12 and newer):
- Main branch:
lua
vim.pack.add({ 'https://github.com/nvim-mini/mini.nvim' })
- Stable branch:
lua
vim.pack.add({
{ src = 'https://github.com/nvim-mini/mini.nvim', version = 'stable' },
})
- Manually with git clone (compatible with mini.deps):
lua
-- Put this at the top of 'init.lua'
local path_package = vim.fn.stdpath('data') .. '/site'
local mini_path = path_package .. '/pack/deps/start/mini.nvim'
if not vim.uv.fs_stat(mini_path) then
vim.cmd('echo "Installing mini.nvim" | redraw')
local clone_cmd = {
'git', 'clone', '--filter=blob:none',
-- Uncomment next line to use 'stable' branch
-- '--branch', 'stable',
'https://github.com/nvim-mini/mini.nvim', mini_path
}
vim.fn.system(clone_cmd)
vim.cmd('packadd mini.nvim | helptags ALL')
vim.cmd('echo "Installed mini.nvim" | redraw')
end
- With folke/lazy.nvim:
- Main branch:
lua
{ 'nvim-mini/mini.nvim', version = false },
- Stable branch:
lua
{ 'nvim-mini/miniTop issues
#2542Beta-testing 'mini.statuscolumn'21 comments · 2026-08-27#2546'mini.nvim' and multicursor18 comments · 2026-09-01#2200[mini.diff] Add customization options to gen_source.git17 comments · 2025-12-31#1818Improve 'mini.jump2d' default config and jumping experience10 comments · 2025-05-22#452mini.cursors: minimal multicursors like helix10 comments · 2023-08-24#2174Feature request: interactive line blame9 comments · 2025-12-15#917how to sponsor you?9 comments · 2024-05-26#1399support mini.icons in mini.starter8 comments · 2024-12-16
Discussions
#2596Can timeoutlen be respected for leader key to be mapped to something past timeout?1 comments · 2026-11-11#2595Create mapping to show/hide dot-files and set CWD1 comments · 2026-11-11#2578Custom treesitter textobjects not working for some languages1 comments · 2026-10-11#2577Emoji picker for mini.pick2 comments · 2026-10-10#2576mini.nvim zen mode based on `MiniMisc.zoom()`2 comments · 2026-10-08#2574[mini.ai] Any way to use multiple keys as a trigger for a text object?2 comments · 2026-10-07#2573How to change a variable after each nested case?1 comments · 2026-10-07#2565[mini.comment] Comments do not work in Svelte files2 comments · 2026-10-02
Latest release
Version 0.18.0 v0.18.0 2026-06-21All
Evolve
- Prefer using 'mini.input' functionality (if module is enabled) to get user input asynchronously. Affected modules:
- mini.ai
- mini.align
- mini.jump2d
- mini.pick
- mini.surround
Refine
- Soft deprecate support for Neovim 0.9. It will be fully deprecated in next release.
mini.base16
Expand
- Add new plugin integrations:
- 'folke/snacks.nvim'
- 'saghen/blink.cmp'
mini.clue
Expand
- Allow mode arrays for clues and triggers for parity with modes parameter of vim.keymap.set. By @pkazmier, PR 2202.
mini.compl