nvim-mini /mini.nvim

Library of 45+ independent Lua modules improving Neovim experience with minimal effort

★ 9,652⑂ 320👁 28⑃ 344● 1,504▤ 18
LuaMITCreated 2021-06-18nvim-mini.org/mini.nvim/
Download: Version 0.18.0Version-0.18.0 ↓0.18.02026-06-21
+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/mini

Top issues

Discussions

Latest release

Version 0.18.0 v0.18.0 2026-06-21
All

 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON