https://github.com/n3tw0rth/keeper.nvim
scrub.nvim is a small, minimal Neovim plugin for managing buffers and restoring them across sessions. It helps you quickly clean up unwanted buffers and automatically brings back your previous buffer list when you reopen Neovim. Inspired by oil.nvim, the focus is simplicity and a lightweight workflow.
https://github.com/n3tw0rth/keeper.nvim
buffers lua nvim plugin
Last synced: about 2 hours ago
JSON representation
scrub.nvim is a small, minimal Neovim plugin for managing buffers and restoring them across sessions. It helps you quickly clean up unwanted buffers and automatically brings back your previous buffer list when you reopen Neovim. Inspired by oil.nvim, the focus is simplicity and a lightweight workflow.
- Host: GitHub
- URL: https://github.com/n3tw0rth/keeper.nvim
- Owner: n3tw0rth
- License: mit
- Created: 2025-08-13T14:49:34.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2025-12-26T07:30:36.000Z (6 months ago)
- Last Synced: 2025-12-27T19:05:39.977Z (6 months ago)
- Topics: buffers, lua, nvim, plugin
- Language: Lua
- Homepage:
- Size: 53.7 KB
- Stars: 18
- Watchers: 0
- Forks: 1
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
oil.nvim inspired nvim plugin to manage buffers and persists open buffers when you close nvim. (scrub.nvim renamed to keeper.nvim)
## Features
* **Effortless Buffer Management**: Quickly close unwanted buffers by updating the buffer (eg: `dd` to remove a line).
* **Session Persistence**: Save and restore the current buffer state across Neovim sessions.
* **Inspired by oil.nvim**: Designed with simplicity and efficiency in mind, drawing inspiration from the `oil.nvim` plugin.
## Installation
Install `keeper.nvim` using your preferred Neovim plugin manager:
**Using Lazy.nvim**:
```lua
return {
"n3tw0rth/keeper.nvim",
config = function()
require("scrub").setup()
end
}
```
**Using Packer**:
```lua
use {
"n3tw0rth/keeper.nvim",
config = function()
require("scrub").setup()
end
}
```
**Using Vim-Plug**:
```vim
Plug 'n3tw0rth/keeper.nvim'
```
## Usage
After installation, you should add the following key mapping to your Neovim configuration to open the plugin. You can also run :Scrub to open the plugin.
```lua
vim.keymap.set("n", "_", "Scrub", { desc = "Open Scrub" })
```
then pressing `_` anytime will open the plugin (in normal mode).
Let's say you removed the unwanted buffers by editing the scrub buffer, then you can save the current buffer by running `:w`. Then if you run `:ls` you should see the unwanted buffers are removed and things clean for you to continue work on.
Then you shall press `Enter` on the required buffer or use a plugin like telescope to open the buffer you want to work on.
Note: the plugin by default saves the current open buffers in `/tmp/scrub.lua` and you will loose the save file when system shutdown. This will improved and will make configurable in the next release.
## Requirements
- Too many open buffers and urge clean that up.
## Configuration
Will be availble in a future release
## License
This plugin is licensed under the MIT License. See the [LICENSE](LICENSE) file for more information.
## Feedback and Contributions
Your feedback and contributions are welcome! If you encounter any issues or have suggestions for improvements, please open an issue or submit a pull request on the [GitHub repository](https://github.com/n3tw0rth/scrub.nvim).