fff-plus.nvim

Extra Neovim pickers for fff.nvim.

fff-plus.nvim is a small extension plugin. Upstream fff.nvim keeps owning the Rust backend, binary downloader, file search, live grep, frecency index, and release pipeline. This plugin adds the picker workflows that are useful day to day but do not need to live in the backend project.

Installation

Install upstream fff.nvim first, then install fff-plus.nvim.

lazy.nvim

{
  'dmtrKovalenko/fff.nvim',
  build = function()
    require('fff.download').download_or_build_binary()
  end,
  lazy = false,
  keys = {
    { '<C-p>', function() require('fff').find_files() end, desc = 'FFF files' },
    { 'fg', function() require('fff').live_grep() end, desc = 'FFF grep' },
  },
},
{
  'vinitkumar/fff-plus.nvim',
  dependencies = { 'dmtrKovalenko/fff.nvim' },
  opts = {
    legacy_commands = false,
  },
  keys = {
    { '<C-b>', function() require('fff_plus').buffers() end, desc = 'FFF+ buffers' },
    { '<leader>c', function() require('fff_plus').colors() end, desc = 'FFF+ colors' },
    { '<leader>g', function() require('fff_plus').git_files() end, desc = 'FFF+ git files' },
  },
}

vim.pack

vim.pack.add({
  'https://github.com/dmtrKovalenko/fff.nvim',
  'https://github.com/vinitkumar/fff-plus.nvim',
})

vim.api.nvim_create_autocmd('PackChanged', {
  callback = function(ev)
    local name, kind = ev.data.spec.name, ev.data.kind
    if name == 'fff.nvim' and (kind == 'install' or kind == 'update') then
      if not ev.data.active then vim.cmd.packadd('fff.nvim') end
      require('fff.download').download_or_build_binary()
    end
  end,
})

require('fff_plus').setup({
  legacy_commands = false,
})

Pickers

API	Command	What it does
require('fff_plus').buffers()	:FFFPlusBuffers	Switch between listed buffers, preview contents, and delete buffers
require('fff_plus').colors()	:FFFPlusColors	Browse colorschemes with live preview and restore on cancel
require('fff_plus').git_files()	:FFFPlusGFiles	Browse files from git status -s with status indicators and preview

Compatibility Aliases

Set legacy_commands = true to also register aliases for muscle memory from fzf.vim-style workflows:

require('fff_plus').setup({
  legacy_commands = true,
})

That enables:

• :FFFBuffers
• :Colors
• :GFiles

If you want old Lua call sites such as require('fff').buffers() to continue working, add a tiny shim in your config:

local plus = require('fff_plus')
local fff = require('fff')

fff.buffers = plus.buffers
fff.colors = plus.colors
fff.git_files = plus.git_files

Maintenance Notes

This repo intentionally does not carry upstream backend code. That keeps the sync burden low, but these pickers still reuse upstream Lua internals:

• fff.conf
• fff.file_picker.preview
• fff.file_picker.icons
• fff.utils
• fff.highlights

If upstream refactors those modules, fff-plus.nvim may need a compatibility update. The long-term ideal is a small public picker-extension API in upstream fff.nvim.

See EXPERIMENT_EXTENSION_PLUGIN.md for the full tradeoff notes.