Skip to content

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

scheme
(load-plugin "core:pickers")

Must be loaded eagerly — it binds g f and g b, which need to be live from the first keystroke.

Picking files

g 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

g b opens a picker over every open buffer, showing each one's path (relative to :pwd when possible) 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.

Keys

KeyEffect
g fOpen the file picker
g bOpen the buffer picker

Once a picker is open:

KeyEffect
TypeFilter the list
BackspaceEdit the query
Down / Ctrl+nMove selection down
Up / Ctrl+pMove selection up
PageDown / PageUpPage the list
EnterOpen the selected item
EscDismiss without opening anything

Released under the MIT License.