readme.md

buff.nvim

When you are exploring a new project you must be switching between a lot of files, this plugin allows you to toggle a list of currently open buffers. Yes, I've heard of ThePrimeagen Harpoon plugin, but the main reason of that plugin is to work with a subset of files, and obviously you must add every single file manually. So having that in mind, this plugin is meant only for those people that want to have a quick list of buffers and switch between them.

Configuration

Lazy.nvim

return {
    'kutiny/buff.nvim',
    lazy = true,
    cmd = { 'BuffListToggle' },
    opts = {
        slim_path = true,
        ignore_patterns = {
            "oil:.*", -- useful if you want to hide custom buffers like oil.nvim
        },
        window = {
            auto_width = true,
            -- fixed_width = 30,
            -- percentage_width = 30, -- or 0.3
        }
    },
    keys = {
        { '<leader>c', function() require('buff').show_buffer_list() end }
    },
}

Config	Description	Default
ignore_patterns	Ignore patterns (do not show them in the list)	{}
slim_path	Shorten path by stripping folder names to three characters	true
window	Window configuration	{ auto_width = true }

If you configure more than one option for window you may want to know its precedence:

1. auto_width
2. percentage_width
3. fixed_width

How to use

If you copied the configuration from before, you can type c to toggle the buffer list, move with vimotions and press enter to select one buffer. If you don't want to select any, you can press the key combination again or just leave that window (it will close automatically.

Deleting buffers

In order to delete a buffer, you can press x on the line of the buffer you want to delete, and that's it, the buffer will be removed if there is no changes pending