modified-buffers.nvim

A lightweight Neovim plugin to quickly view and navigate to modified buffers in a clean floating window.

Features

• 🎨 Clean floating window with file icons (using nvim-web-devicons)
• ⚡ Fast navigation - press Enter to jump to a buffer
• 🎯 Shows only modified buffers (unsaved changes)
• 🎨 Syntax-highlighted file icons matching file types
• ⌨️ Simple keybindings (q, Esc to close, Enter to select)

Requirements

• Neovim >= 0.8.0
• nvim-web-devicons (optional, for file icons)

Installation

Using lazy.nvim

{
  'benbpyle/modified-buffers.nvim',
  keys = {
    { '<leader>bl', '<cmd>ModifiedBuffers<cr>', desc = 'Modified [B]uffer [L]ist' },
  },
  opts = {},
}

Using packer.nvim

use {
  'benbpyle/modified-buffers.nvim',
  config = function()
    require('modified-buffers').setup()
  end
}

Using vim-plug

Plug 'benbpyle/modified-buffers.nvim'

Usage

Command

:ModifiedBuffers

Keybindings (in the floating window)

• Enter - Jump to the selected buffer
• q or Esc - Close the window
• j/k - Navigate up/down

Configuration

You can customize the plugin by passing options to the setup function:

require('modified-buffers').setup({
  width = 50,           -- Width of the floating window
  max_height = 15,      -- Maximum height of the floating window
  border = 'rounded',   -- Border style: 'rounded', 'single', 'double', 'solid', 'shadow'
  title = ' Modified Buffers ',  -- Window title
})

With lazy.nvim

{
  'benbpyle/modified-buffers.nvim',
  keys = {
    { '<leader>bl', '<cmd>ModifiedBuffers<cr>', desc = 'Modified [B]uffer [L]ist' },
  },
  opts = {
    width = 60,
    border = 'double',
  },
}

Why This Plugin?

Built out of a need for a simple, focused way to see which buffers have unsaved changes without the clutter of showing all open buffers. Perfect for keeping track of your work-in-progress files.

License

BSD 3-Clause - see LICENSE for details

Contributing

Issues and pull requests are welcome!