Skip to content

FZF & Search Tools

FZF

fzf is the backbone of interactive selection throughout the setup.

Keybindings

Key Action
Ctrl+T File picker (with bat preview)
Ctrl+R History search (handled by atuin)
Alt+C Directory picker

Theme

Uses Catppuccin Mocha colors for consistent appearance across all fzf prompts.

Where FZF is Used

  • af — AWS profile selection
  • txf — Talos context selection
  • gh-browse — GitHub repo browser
  • Tmux session picker (++prefix+f++)
  • Tmux dev/claude layouts (directory selection)
  • git wipeout — Branch deletion (via gum)
  • Sesh directory picker

Zoxide

Zoxide is a smarter cd that learns your habits.

z project      # Jump to most-used directory matching "project"
zi             # Interactive selection with fzf

Zoxide feeds into the sesh directory picker, making tmux session creation aware of your most-visited directories.

Importing History

# From z.sh
zoxide import --from=z ~/.z

Atuin

Atuin replaces shell history search with a SQLite-backed, fuzzy-searchable history.

Settings

Setting Value
Search mode Fuzzy
Filter mode Global (all hosts)
Sync Disabled (local only)
Style Compact
Inline height 30 lines
Keymap Auto (vim in vim, emacs elsewhere)

Usage

# Start typing and press Ctrl+R for fuzzy history search
# Or use up arrow for prefix search (atuin's up-arrow is disabled,
# using zsh's built-in prefix search instead)

Carapace

Carapace bridges completions from multiple shell ecosystems:

CARAPACE_BRIDGES='zsh,fish,bash,inshellisense'

Provides completions for tools that only ship fish or bash completers.

Bat

Bat is a cat replacement with syntax highlighting.

  • Theme: Catppuccin Mocha
  • Used as the preview command for fzf (Ctrl+T)

Yazi

Yazi is a terminal file manager.

y    # Open yazi in current directory