wkd

Files & navigation · beta · Neovim 0.10+ · 228 commits

pickers.nvim

One :Pickers command over telescope.nvim, fzf-lua and snacks.nvim. Seven separate picker modules consolidated into one grammar — :Pickers <scope> <action> — with the engine auto-detected and every scope, action and native picker completing with <Tab>.

Repository README :help

recorded with VHS from demos/pickers.tape in a clean Neovim — re-recorded weekly
what is shown when
  1. :Pickers cwd files - files under the working directory
  2. :Pickers cwd grep - live grep, same scope, same command

Install

{
  "StefanBartl/pickers.nvim",
  opts = {},
}

Beta stage — active development. This repository is past its first shape and in active use, but the surface is not frozen: breaking changes are still possible. Pin a commit or tag if you depend on it.

Documentation

Recent commits

  1. fix tabs: arm_tag tags every matching buffer, smart carries its query, native fallback follows the physical lhs, git group default fixed
  2. fix snacks: forward the tab-switch query (pattern for files, search for live pickers)
  3. fix tabs: builtin targets run via pickers.builtins; only tab-opened pickers switch, <Tab> keeps multi-select elsewhere
  4. fix tabs: tab_next/tab_prev no longer close a picker outside a tab group; <Tab>/<S-Tab> keep native multi-select
  5. fix entry_actions: directory links keep a title, feedback text fits the command line, insert goes to the current editing window
  6. feat entry_actions: copy/open/reveal/insert report what they did, also in :messages
  7. feat entry_actions: insert Markdown links into the window behind the picker
  8. fix keys,entry_actions: review pass -- key collisions, existence check, special buffers