oil.nvim is a Neovim file explorer that lets you edit your filesystem like a buffer.
The tool solves the problem of navigating and manipulating files through a traditional file browser interface by instead treating directories as editable buffers. You open a directory, see its contents displayed as buffer lines, and perform file operations—creating, deleting, renaming, moving—by editing the buffer directly. Changes are staged until you write the buffer with `:w`, at which point the actual filesystem operations execute. This approach mirrors vim-vinegar's philosophy of minimal, keyboard-driven file management.
The tool suits developers who prefer text-based workflows and want to avoid context-switching to a separate file browser UI. It works well for projects where you need to batch-rename files, reorganize directory structures, or perform complex file operations that are cumbersome in traditional explorers. The standout capability is its adapter abstraction, which extends beyond local filesystem browsing: SSH and S3 adapters allow you to browse and manipulate remote files over SSH or in AWS S3 buckets using the same buffer-editing interface, and file operations work across adapters, so you can copy files between local and remote locations seamlessly. The tool requires Neovim 0.10 or later and optionally integrates with icon providers like mini.icons or nvim-web-devicons.
Development activity shows consistent maintenance with support for multiple Neovim versions through branching for older releases. The project maintains a structured documentation approach including recipes for common customizations and an API surface for third-party extensions. The codebase is written in Lua and integrates with the standard Neovim plugin ecosystem, supporting installation through all major plugin managers.
