Fuzzy Finder

A modal panel for jumping straight to a file or an open buffer, without leaving the keyboard: type a few characters, watch the list narrow, Enter to go there.

Setup

(load-plugin! "core:stdlib")
(load-plugin! "core:pickers")

It has no manifest, so it loads at startup: z f and z b are the only way to reach its commands, and nothing else could wake it. core:stdlib only needs to be loaded before it.

Picking files

z f opens a file picker scoped to HUME's working directory (:pwd; change it with :cd):

• Inside a git repository, it lists every file git knows about: tracked files plus untracked-but-not-ignored ones. This reads straight from git's index, so it stays fast even in huge repos.
• Outside a git repository, it lists files with fd (or Debian's fdfind package) if you have it installed.
• If neither applies, the picker tells you to install fd.

Selecting a tracked-but-deleted file (removed from disk without git rm) fails to open: git's index doesn't know it's gone.

Picking buffers

z b opens a picker over every open buffer, showing each one's full path rather than just its filename, so two open files that happen to share a name, like two different mod.rs files, show up as distinct, disambiguated rows.

Picking modified files

z m opens a picker over every file with staged or unstaged changes, as reported by git status: the row shows the two-letter status (M staged, M unstaged, ?? untracked, and so on) alongside the path, so you can tell at a glance what kind of change each file has. Selecting a row opens that file, regardless of which subdirectory :pwd currently points at.

A working directory outside any git repository shows a status message instead of opening a picker. A clean tree (nothing changed) opens the picker with no rows.

By default, untracked files are included, each shown as its own row. Turn them off when loading the plugin:

(load-plugin! "core:stdlib")
(load-plugin! "core:pickers" #:config (hash "untracked" #f))

Value	Effect
#t (default)	Untracked files are included.
#f	Untracked files are left out entirely.

Keys

Key	Effect
z f	Open the file picker
z b	Open the buffer picker
z m	Open the modified-files picker

Once a picker is open:

Key	Effect
Type	Filter the list
Backspace	Edit the query
Down / Ctrl-n	Move selection down
Up / Ctrl-p	Move selection up
PageDown / PageUp	Page the list
Ctrl-d / Ctrl-u	Move selection by half a page
Enter / Ctrl-o	Open the selected item in the current pane
Ctrl-t	Open the selected item in a new tab
Ctrl-v	Open the selected item in a side-by-side split
Ctrl-s	Open the selected item in a stacked split
Esc	Dismiss without opening anything