canola.nvim

oil.nvim with 133 upstream issues and PRs triaged. Drop-in replacement — zero config changes needed.

canola-preview-v0.1.0.mp4

Installation

Swap stevearc/oil.nvim for barrettruth/canola.nvim. Everything else is identical — same module, same config, same keymaps, same require('oil').setup(opts).

{ 'barrettruth/canola.nvim', opts = {} }

Or via luarocks:

luarocks install canola.nvim

Quick Start

Put canola on a parent-directory key when you want a vinegar-style entry point.

vim.keymap.set('n', '-', '<CMD>Oil<CR>', { desc = 'Open parent directory' })

Open a project directory when you want to browse and edit it as a buffer.

nvim .

Inside the listing, press <CR> to open a file or descend into a directory, and press - to move back up.

Rename, create, or delete entries by editing the listing as text, then write the buffer to apply the filesystem changes.

:w

See :help canola for full documentation.

Requirements

• Neovim 0.10+
• (Optionally) an icon provider: mini.icons, nvim-web-devicons, or nonicons.nvim

Similar Projects

• stevearc/oil.nvim — the original
• 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

• stevearc: oil.nvim