fzf-oil.nvim

A tiny (<300 LOC) plugin combining fzf-lua and oil.nvim for finding and file browsing, with seamless toggling between them.

Features

• Browse directories with fzf-lua, navigate into subdirectories or up to parent.
• Toggle into oil.nvim for full directory editing, toggle back to fzf.
• Window sizing, backdrop, and border are inherited from your fzf-lua config.
• Recursive find mode to search across all subdirectories.
• All keybindings are configurable.

Requirements

• Neovim 0.11+
• fzf-lua
• oil.nvim
• fd

Installation

With vim.pack:

vim.pack.add({
    "https://github.com/ibhagwan/fzf-lua",
    "https://github.com/stevearc/oil.nvim",
    "https://github.com/ingur/fzf-oil.nvim",
})

With lazy.nvim:

{
    "ingur/fzf-oil.nvim",
    dependencies = {
        "ibhagwan/fzf-lua",
        "stevearc/oil.nvim",
    },
}

Quickstart

-- use fzf-oil's float helper so oil matches fzf-lua's dimensions
require("oil").setup({
    float = require("fzf-oil").float,
})

local browser = require("fzf-oil").setup()

vim.keymap.set("n", "<leader>fb", browser.browse, { desc = "File browser" })

Tip

require("fzf-oil").float provides an override that syncs oil's floating window size and border with your fzf-lua config. You can also use require("fzf-oil").override directly in your own oil float config.

Defaults

local defaults = {
    cmd = "fd --max-depth 1 --hidden --exclude .git --type f --type d --type l",
    find_cmd = "fd --hidden --exclude .git --type f --type l",
    cwd = function()        -- falls back to getcwd() for non-file buffers
        local dir = vim.fn.expand("%:p:h")
        if dir ~= "" and vim.fn.isdirectory(dir) == 1 then
            return dir
        end
        return vim.fn.getcwd()
    end,
    start_mode = "fzf", -- "fzf" or "oil"
    zindex = 40,
    border = "rounded",
    keys = {
        parent = "<C-h>",
        child = "<C-l>",
        toggle_find = "<C-f>",
        edit = "<C-e>",
        quit = "q",
        home = "<C-g>",
    },
    fzf_exec_opts = {},
}

Keybindings

fzf mode

Key	Action
<CR>	Open file or enter directory
<C-h>	Go to parent directory
<C-l>	Enter directory
<C-f>	Toggle recursive find mode
<C-e>	Switch to oil
<C-g>	Jump to home directory

oil mode

Key	Action
<C-e>	Switch back to fzf
q	Switch back to fzf
<C-g>	Jump to home directory

All keys are configurable through setup({ keys = { ... } }).