Select and customize text objects for editing surrounding or inner regions.
Good to know
Enable this module separately with its setup() function.
Get it on GitHub
Unclaimed
Are you @nvim-mini?Claim it, and your coding agent keeps it current with each release
Written by 
Are you @nvim-mini?Claim it, and your coding agent keeps it current with each release
Edit text, browse files, search your project, manage sessions, and customize Neovim with individually enabled tools.
What you can do with mini.nvim
Align text interactively.
Good to know
Enable this module separately with its setup() function.
Animate cursor movement, scrolling, and window transitions.
Good to know
Enable this module separately with its setup() function.
Apply a color scheme built from a Base16 palette.
Good to know
Enable this module separately with its setup() function.
Configure common editor options and mappings with presets.
Good to know
Enable this module separately with its setup() function.
Navigate forward and backward through related editor items with bracket mappings.
Good to know
Enable this module separately with its setup() function.
Remove buffers while preserving the window layout.
Good to know
Enable this module separately with its setup() function.
Comment and uncomment lines.
Good to know
Enable this module separately with its setup() function.
Show all 47
Complete text and view signature help while typing.
1 other tool for: Complete codeGood to know
Enable this module separately with its setup() function.
Highlight occurrences of the word under the cursor.
Good to know
Enable this module separately with its setup() function.
Generate Neovim help files from annotated source.
Good to know
Enable this module separately with its setup() function.
Find approximate text matches with fuzzy matching.
Good to know
Enable this module separately with its setup() function.
Visualize and navigate indentation scopes.
Good to know
Enable this module separately with its setup() function.
Jump to the next or previous occurrence of a character.
Good to know
Enable this module separately with its setup() function.
Jump to labeled positions within visible lines.
Good to know
Enable this module separately with its setup() function.
View an overview of buffer text in a separate window.
Good to know
Enable this module separately with its setup() function.
Move a selection in any direction.
Good to know
Enable this module separately with its setup() function.
Insert paired delimiters automatically.
Good to know
Enable this module separately with its setup() function.
Save and restore editing sessions.
Good to know
Enable this module separately with its setup() function.
Split and join arguments across lines.
Good to know
Enable this module separately with its setup() function.
Open files and sessions from a customizable start screen.
Good to know
Enable this module separately with its setup() function.
View file and editor information in a statusline.
Good to know
Enable this module separately with its setup() function.
Add, delete, replace, and find surrounding delimiters.
Good to know
Enable this module separately with its setup() function.
View open buffers in a tabline.
Good to know
Enable this module separately with its setup() function.
Test Neovim plugins, including interactions with child Neovim processes.
Good to know
Enable this module separately with its setup() function.
Highlight and remove trailing whitespace.
Good to know
Enable this module separately with its setup() function.
Zoom an editing window and configure automatic working-directory changes.
Good to know
Configure the desired helpers explicitly.
Adjust, preview, and save color schemes.
Good to know
Terminal transparency requires a terminal emulator that supports it.
Highlight configurable patterns in text.
Good to know
No highlighters are enabled by default; configure highlighters explicitly.
Generate a color scheme from background and foreground colors.
Good to know
Supply background and foreground colors.
See available next keys and their descriptions while entering a key sequence.
Good to know
Configure opt-in triggers; triggers override matching buffer-local mappings. Operator-pending triggers have limitations.
Browse directories and create, rename, copy, move, or delete files by editing text buffers.
Good to know
File operations require filesystem permissions; cyclic renames and moving a directory inside itself are unsupported.
Evaluate, exchange, duplicate, replace, and sort text with repeatable operators.
Good to know
Enable this module separately with its setup() function.
Search and select files, buffers, help tags, and text matches with previews.
Good to know
External search tools have their own matching and ignore behavior; configure custom sources when needed.
Select diagnostics, Git history, LSP results, and other editor data through pickers.
Good to know
Each picker or helper requires the corresponding mini module; LSP and Git pickers need their respective data sources.
Install, update, remove, and snapshot Neovim plugins.
1 other tool for: Manage pluginsGood to know
Development is frozen. The project recommends vim.pack on Neovim 0.12+; mini.deps remains available at least while Neovim 0.11 is supported.
View notifications and LSP progress in a floating window and revisit their history.
Good to know
Enable this module separately with its setup() function.
Track, label, and revisit files and directories across sessions.
Good to know
Renames outside mini.files require manual visit-index updates before the next write.
Inspect, navigate, apply, and reset changes between a buffer and its reference text.
Good to know
Default reference is the Git index; staging is supported, but unstaging hunks is not.
Run Git commands and inspect file or line history from Neovim.
1 other tool for: Inspect Git historyGood to know
Requires Git; this is not a full Git client.
Display icons for files, directories, filetypes, and LSP item kinds.
Good to know
Use ASCII style if your font lacks the icon glyphs.
Run Neovim plugin tests on Windows.
Good to know
Requires a supported Neovim installation on Windows.
Synchronize the terminal background with Neovim's color scheme.
Good to know
Requires Neovim 0.10 or newer and terminal support.
Expand context-dependent snippets and edit linked tabstops.
1 other tool for: Expand snippetsGood to know
Configure your own snippet collection; none is bundled. Default sessions do not support variable or tabstop transformations.
Map keys to conditional editing actions or timed key combinations.
Good to know
Configure mappings explicitly; integrations require the corresponding completion, snippet, or pairing tool.
Autocomplete and autocorrect command-line input and preview command ranges.
Good to know
Autocomplete requires Neovim 0.11+, with 0.12 recommended. Uses built-in completion candidates and does not replace the command-line UI.
Enter text through customizable non-blocking prompts.
Good to know
Setup replaces vim.ui.input; restore another implementation after setup if desired.
Before you upgrade mini.nvim
Newest firstPlan to upgrade Neovim 0.9 to 0.10 or newer: 0.9 support is soft deprecated and the README now recommends 0.10+. Full deprecation is announced for the next release.
Read the evidence
Development is frozen; on Neovim 0.12+ the project recommends `vim.pack`. The module remains available at least while Neovim 0.11 is supported, with possible critical fixes.
Read the evidence
Hex-color highlighting now defaults to at most 10000 distinct highlight groups; adjust `max_number` to control the limit.
Read the evidence
Show 22 older
Dot-repeat preserves the last editing jump independently of regular jumps: after `dte`, then `fx`, dot repeats `dte`.
Read the evidence
Custom asynchronous previews may need explicit `:redraw`; the picker no longer redraws continuously every `config.delay.async` milliseconds.
Read the evidence
Pass tested arguments inside closures for `expect.error`/`expect.no_error`, not as extra arguments. Replace removed `ignore_lines` with both `ignore_text` and `ignore_attr`.
Read the evidence
Built-in reporters show failures before notes. Expectations accept custom failure reasons, and equality errors explain differing characters or table keys.
Read the evidence
Label prompts use customizable `vim.ui.input()` instead of `vim.fn.input()`.
Read the evidence
When mini.input is enabled, mini.ai, mini.align, mini.jump2d, mini.pick, and mini.surround use its asynchronous input prompts.
Read the evidence
Blank lines are no longer included in comment textobjects by default.
Read the evidence
`setup_termbg_sync()` now resets the terminal background with OSC 111. Set `opts.explicit_reset = true` to restore the previous explicit-color reset.
Read the evidence
Upgrade to Neovim 0.9 or newer; official support for 0.8 has ended. Repository sources now use `nvim-mini/mini.nvim`; old URLs redirect, but updating them is recommended.
Read the evidence
`setup()` now installs the module's `vim.notify` implementation; restore a different implementation after setup if desired.
Read the evidence
`setup()` installs `vim.ui.select`. Ripgrep searches now force case matching from `ignorecase`/`smartcase`; paste accepts cursor-word, WORD, line, and filename registers.
Read the evidence
Tree-sitter textobjects now default `use_nvim_treesitter` to `false`, using built-in tree-sitter; the option is scheduled for removal.
Read the evidence
`options.win_border` now defaults to `auto`, deriving border-related fill characters from `winborder`.
Read the evidence
Setup removes the `t` flag from `complete` when the option was not previously set and fallback completion is default, avoiding tag-completion delays.
Read the evidence
The clue window title uses the current query's description instead of literal keys; bracket-key clues are available.
Read the evidence
The default `write_pre` hook removes top-of-file `===` and `---` delimiters for compatibility with help additions.
Read the evidence
Appending `/` to a file entry means delete the file and create a directory. Previews remain visible for new entries; `config.content.highlight` customizes entry highlighting.
Read the evidence
Theme highlights auto-adjust to message separators and popup borders, with an `autoadjust` opt-out. Terminal black/white colors differ from foreground/background; four seasonal themes are bundled.
Read the evidence
Rename `gen_pattern_spotter` to `gen_spotter.pattern` and `gen_union_spotter` to `gen_spotter.union`; old names warn. Word-start jumps now follow `iskeyword`, and non-focusable windows are ignored.
Read the evidence
Reading a session writes the current session only when `MiniSessions.config.autowrite` is true.
Read the evidence
Recreate the removed `update_n_lines` mapping using `MiniSurround.update_n_lines()` if needed. Setup may map unused `s` to `<Nop>`; tree-sitter surroundings default to built-in tree-sitter.
Read the evidence
Replace screenshot `ignore_lines` with both `ignore_text` and `ignore_attr` using the same line list; the old option is soft deprecated.
Read the evidence
mini.nvim release history 11
Let language servers respond to file renames in the explorer.
Details
Adds mini.input and LSP-aware file operations in mini.files.
Install tag v0.18.0 and enable desired modules. README recommends Neovim 0.10+; 0.9 is soft deprecated.
Added: Enter text through customizable non-blocking prompt…Action requiredImproved: Browse directories and create, rename, copy, move,…Now works: Browse directories and create, rename, copy, move,…Behavior changed: Install, update, remove, and snapshot Neovim plugin…Improved: Complete text and view signature help while typing.Improved: See available next keys and their descriptions whil…Improved: Select diagnostics, Git history, LSP results, and o…Behavior changed: Highlight configurable patterns in text.Behavior changed: Jump to the next or previous occurrence of a charac…Now works: Insert paired delimiters automatically.Improved: Search and select files, buffers, help tags, and te…Action required: Search and select files, buffers, help tags, and te…Improved: Save and restore editing sessions.Improved: Add, delete, replace, and find surrounding delimite…Action required / inferred: Test Neovim plugins, including interactions with ch…Behavior changed: Test Neovim plugins, including interactions with ch…Behavior changed: Track, label, and revisit files and directories acr…Improved: Generate a color scheme from background and foregro…Improved: Apply a color scheme built from a Base16 palette.Behavior changedBehavior changed / inferred: Comment and uncomment lines.Behavior changed: Synchronize the terminal background with Neovim's c…
Seeded by @iluxav with Codex
Complete command-line input automatically.
Details
Adds mini.cmdline and changes setup defaults for notifications and selection prompts.
Install tag v0.17.0 and enable desired modules. Neovim 0.9+; command-line completion requires 0.11+.
Added: Autocomplete and autocorrect command-line input and…Action requiredBehavior changed: View notifications and LSP progress in a floating w…Behavior changed: Search and select files, buffers, help tags, and te…Behavior changed: Select and customize text objects for editing surro…Behavior changed: Configure common editor options and mappings with p…Behavior changed: Complete text and view signature help while typing.Behavior changed: See available next keys and their descriptions whil…Improved: Inspect, navigate, apply, and reset changes between…Behavior changed: Generate Neovim help files from annotated source.Improved: Select diagnostics, Git history, LSP results, and o…Behavior changed: Browse directories and create, rename, copy, move,…Behavior changed: Generate a color scheme from background and foregro…Action required: Jump to labeled positions within visible lines.Behavior changed: Save and restore editing sessions.Action required: Add, delete, replace, and find surrounding delimite…Action required: Test Neovim plugins, including interactions with ch…Improved: View an overview of buffer text in a separate windo…
Seeded by @iluxav with Codex
Make editing keys choose actions based on context.
Details
Adds mini.keymap and snippet support in mini.completion.
Install tag v0.16.0 and enable desired modules. Neovim 0.8+.
Added: Map keys to conditional editing actions or timed ke…Action requiredBehavior changedBehavior changed: Select and customize text objects for editing surro…Behavior changed: Complete text and view signature help while typing.Improved: Inspect, navigate, apply, and reset changes between…Behavior changed: Find approximate text matches with fuzzy matching.Behavior changed: Evaluate, exchange, duplicate, replace, and sort te…Improved: Insert paired delimiters automatically.Action required: Search and select files, buffers, help tags, and te…Improved: Expand context-dependent snippets and edit linked t…Behavior changed: View file and editor information in a statusline.Improved: Add, delete, replace, and find surrounding delimite…Behavior changed: View open buffers in a tabline.Improved: View notifications and LSP progress in a floating w…Improved: Comment and uncomment lines.
Seeded by @iluxav with Codex
Expand snippets and edit linked tabstops.
Details
Adds mini.snippets and glob filtering for picker searches.
Install tag v0.15.0 and enable desired modules. Neovim 0.8+.
Added: Expand context-dependent snippets and edit linked t…Improved: Align text interactively.Behavior changed: Animate cursor movement, scrolling, and window tran…Action required / inferred: Browse directories and create, rename, copy, move,…Action required / inferred: Highlight configurable patterns in text.Behavior changed: Visualize and navigate indentation scopes.Behavior changed: Search and select files, buffers, help tags, and te…Behavior changed: Add, delete, replace, and find surrounding delimite…Behavior changed: Test Neovim plugins, including interactions with ch…Improved: Run Git commands and inspect file or line history f…Improved: Generate a color scheme from background and foregro…Improved: View notifications and LSP progress in a floating w…Improved: Display icons for files, directories, filetypes, an…Action required / inferred: Search and select files, buffers, help tags, and te…Improved: Search and select files, buffers, help tags, and te…
Seeded by @iluxav with Codex
Bookmark directories in the file explorer.
Details
Adds mini.icons and directory bookmarks in mini.files.
Install tag v0.14.0 and enable desired modules. Neovim 0.8+.
Added: Display icons for files, directories, filetypes, an…Action requiredAction required: Browse directories and create, rename, copy, move,…Action required: Search and select files, buffers, help tags, and te…Action required: Open files and sessions from a customizable start s…Behavior changed: Generate Neovim help files from annotated source.Behavior changed: Select diagnostics, Git history, LSP results, and o…Improved: Highlight configurable patterns in text.Improved: Generate a color scheme from background and foregro…Improved: Run Git commands and inspect file or line history f…Behavior changed: View file and editor information in a statusline.Behavior changed: Add, delete, replace, and find surrounding delimite…Added: Run Neovim plugin tests on Windows.Added: Synchronize the terminal background with Neovim's c…Behavior changed: Browse directories and create, rename, copy, move,…
Seeded by @iluxav with Codex
Inspect and stage diff hunks from your editing buffer.
Details
Adds mini.diff and mini.git.
Install tag v0.13.0 and enable desired modules. Neovim 0.7+.
Added: Inspect, navigate, apply, and reset changes between…Added: Run Git commands and inspect file or line history f…Behavior changed: Comment and uncomment lines.Action required: Search and select files, buffers, help tags, and te…Behavior changed: View file and editor information in a statusline.Behavior changed: Generate a color scheme from background and foregro…Behavior changed: Test Neovim plugins, including interactions with ch…Improved: View open buffers in a tabline.Improved: View an overview of buffer text in a separate windo…Improved: Browse directories and create, rename, copy, move,…Action required / inferredImproved: Install, update, remove, and snapshot Neovim plugin…
Seeded by @iluxav with Codex
Install and update Neovim plugins with snapshots.
Details
Adds mini.deps, mini.notify, and mini.visits.
Install tag v0.12.0 and enable desired modules. Neovim 0.7+.
Added: Install, update, remove, and snapshot Neovim plugin…Added: View notifications and LSP progress in a floating w…Added: Track, label, and revisit files and directories acr…Action required: Configure common editor options and mappings with p…Behavior changed: Generate Neovim help files from annotated source.Behavior changed: Generate a color scheme from background and foregro…Improved: Browse directories and create, rename, copy, move,…Behavior changed: Save and restore editing sessions.Behavior changed: View file and editor information in a statusline.Improved: Search and select files, buffers, help tags, and te…Improved: Open files and sessions from a customizable start s…Improved: Comment and uncomment lines.Action required / inferred: Apply a color scheme built from a Base16 palette.Action required / inferred: Generate a color scheme from background and foregro…
Seeded by @iluxav with Codex
Search files and text through a picker with previews.
Details
Adds mini.pick and mini.extra.
Install tag v0.11.0 and enable desired modules. Neovim 0.7+.
Added: Search and select files, buffers, help tags, and te…Added: Select diagnostics, Git history, LSP results, and o…Action required: Apply a color scheme built from a Base16 palette.Action required: Generate a color scheme from background and foregro…Behavior changed: Remove buffers while preserving the window layout.Behavior changed: Browse directories and create, rename, copy, move,…Action required: Highlight configurable patterns in text.Behavior changed: Test Neovim plugins, including interactions with ch…Behavior changed: Complete text and view signature help while typing.Improved: Comment and uncomment lines.Improved: See available next keys and their descriptions whil…Improved: View an overview of buffer text in a separate windo…Improved: Open files and sessions from a customizable start s…
Seeded by @iluxav with Codex
Manage files and directories by editing explorer buffers.
Details
Adds mini.files, mini.clue, and mini.operators.
Install tag v0.10.0 and enable desired modules. Neovim 0.7+.
Added: See available next keys and their descriptions whil…Added: Browse directories and create, rename, copy, move,…Added: Evaluate, exchange, duplicate, replace, and sort te…Behavior changed: Configure common editor options and mappings with p…Behavior changed: Remove buffers while preserving the window layout.Improved: Select and customize text objects for editing surro…Improved: Navigate forward and backward through related edito…Improved: Add, delete, replace, and find surrounding delimite…Improved: Insert paired delimiters automatically.Improved: Jump to labeled positions within visible lines.
Seeded by @iluxav with Codex
Adjust and save Neovim color schemes.
Details
Adds mini.colors, mini.hipatterns, and mini.hues.
Install tag v0.9.0 and enable desired modules. Neovim 0.7+.
Added: Adjust, preview, and save color schemes.Added: Highlight configurable patterns in text.Added: Generate a color scheme from background and foregro…Action requiredAction required: Apply a color scheme built from a Base16 palette.Behavior changed: Comment and uncomment lines.Improved: Configure common editor options and mappings with p…
Seeded by @iluxav with Codex
v0.9.0
Starting point
Starting point
Edit text with independently enabled Neovim tools.
Details
Records editing, navigation, appearance, session, and plugin-testing capabilities that existed before the release window.
Capabilities available by v0.9.0; Neovim 0.7 or newer. Enable each desired module separately.
Added: Select and customize text objects for editing surro…Added: Align text interactively.Added: Animate cursor movement, scrolling, and window tran…Added: Apply a color scheme built from a Base16 palette.Added: Configure common editor options and mappings with p…Added: Navigate forward and backward through related edito…Added: Remove buffers while preserving the window layout.Added: Comment and uncomment lines.Added: Complete text and view signature help while typing.Added: Highlight occurrences of the word under the cursor.Added: Generate Neovim help files from annotated source.Added: Find approximate text matches with fuzzy matching.Added: Visualize and navigate indentation scopes.Added: Jump to the next or previous occurrence of a charac…Added: Jump to labeled positions within visible lines.Added: View an overview of buffer text in a separate windo…Added: Move a selection in any direction.Added: Insert paired delimiters automatically.Added: Save and restore editing sessions.Added: Split and join arguments across lines.Added: Open files and sessions from a customizable start s…Added: View file and editor information in a statusline.Added: Add, delete, replace, and find surrounding delimite…Added: View open buffers in a tabline.Added: Test Neovim plugins, including interactions with ch…Added: Highlight and remove trailing whitespace.Added: Zoom an editing window and configure automatic work…
Seeded by @iluxav with Codex
Read the evidence
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-ai.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-align.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-animate.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-base16.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-basics.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-bracketed.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-bufremove.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-comment.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-completion.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-cursorword.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-doc.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-fuzzy.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-indentscope.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-jump.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-jump2d.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-map.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-move.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-pairs.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-sessions.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-splitjoin.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-starter.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-statusline.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-surround.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-tabline.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-test.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-trailspace.md
- nvim-mini/mini.nvim/blob/v0.9.0/readmes/mini-misc.md