Barrett Ruth
81cf5b8b8f
Problem: Makefile was added in
|
||
|---|---|---|
| .github | ||
| doc | ||
| lua | ||
| perf | ||
| plugin | ||
| spec | ||
| syntax | ||
| .busted | ||
| .editorconfig | ||
| .gitignore | ||
| .luarc.json | ||
| .pre-commit-config.yaml | ||
| .prettierrc | ||
| .stylua.toml | ||
| flake.lock | ||
| flake.nix | ||
| LICENSE | ||
| oil.nvim-scm-1.rockspec | ||
| README.md | ||
| selene.toml | ||
| vim.toml | ||
oil.nvim
A file explorer that lets you edit your filesystem like a buffer
Browse directories as normal Neovim buffers, then create, rename, move, copy, and delete files by editing the listing and saving. Cross-directory operations work seamlessly across local, SSH, S3, and trash adapters.
https://user-images.githubusercontent.com/506791/209727111-6b4a11f4-634a-4efa-9461-80e9717cea94.mp4
Features
- Edit directory listings as normal buffers — mutations are derived by diffing
- Cross-directory move, copy, and rename across any adapter
- Adapters for local filesystem, SSH, S3, and OS trash
- File preview in split or floating window
- Configurable columns (icon, size, permissions, timestamps)
- Executable file highlighting and filetype-aware icons
- Floating window and split layouts
Requirements
- Neovim 0.10+
- Optional: mini.icons or nvim-web-devicons for file icons
Installation
Install with your package manager of choice or via luarocks:
luarocks install oil.nvim
Documentation
:help oil.nvim
FAQ
Q: How do I set up oil.nvim with lazy.nvim?
{
'barrettruth/oil.nvim',
init = function()
vim.g.oil = {
columns = { 'icon', 'size' },
delete_to_trash = true,
}
end,
}
Do not use config, opts, or lazy — oil.nvim loads itself when you open a
directory.
Q: How do I migrate from stevearc/oil.nvim?
Replace stevearc/oil.nvim with barrettruth/oil.nvim in your plugin manager
and switch your setup() call to a vim.g.oil assignment in init. The
configuration table is the same.
Q: Why "oil"?
From the vim-vinegar README, a quote by Drew Neil:
Split windows and the project drawer go together like oil and vinegar
Q: What are some alternatives?
- stevearc/oil.nvim: the original oil.nvim
- mini.files: cross-directory filesystem-as-buffer with a column view
- vim-vinegar: the granddaddy of single-directory file browsing
- dirbuf.nvim: filesystem as buffer without cross-directory edits
- lir.nvim: vim-vinegar style with Neovim integration
- vim-dirvish: stable, simple directory browser
Acknowledgements
oil.nvim was created by Steven Arcangeli. This fork is maintained by Barrett Ruth.