NORMAL ~/wkd/p/pickers :set skin=modern utf-8

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>.

status
beta — 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.
category
Files & navigation
neovim
0.11+
repo
github.com/WKDSteve/pickers.nvim
commits
297
help
:help pickers

demo

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

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

docs/

git log

  1. test sheets: smart-picker listing and keystroke measured on 10 000 files, with and without the helper
  2. fix smart: cut the root from a listed path also when the tool printed it resolved
  3. perf smart: list each root once and filter per keystroke instead of fd per key
  4. test sheets: the real fd and the collection folders of the installed config
  5. feat builtins: :Pickers builtin without a name opens the choice of the builtins
  6. test sheets: the keys and commands of the bindings checklist as test sheets
  7. docs regenerate the connection pictures (optional loads through probe/safe/package.loaded)
  8. test sheets: the sheets name the acceptance task their judge and manual lines go to
  9. test sheets: pickers.items on the real telescope, fzf-lua and snacks, as feature sheets
  10. test drives: the drives.roots checks know WSL, where no process is started
  11. docs builtins: pick_item has per-call keys since pickers.items; the filter rows stay
  12. fix items: without marks a key acts on the row under the cursor

keys

j / k
next / previous line
gg / G
first / last line
⏎
open the line under the cursor
/
search plugins and apps (app: x or plugin: x narrows)
:
command line — Tab completes
:help x
vimdoc of a plugin (:e x = plugin page)
:ls · :apps · :play · :log · :stack
plugin list · app list · play area · activity stream · dependency graph
:log apps
the stream of one area (plugins or apps)
:colo x
colorscheme
:set skin=
modern | tui
?
this help
esc
close