fuzzy-nav.zsh 🚀

July 18, 2026 · View on GitHub

A high-speed, stateful Terminal User Interface (TUI) directory navigator and file browser built natively into Zsh, driven by fzf and fd.

Features custom high-performance, directory-bubbled Git status color coding, visual media decoding, cross-platform clipboard interactions, and robust input safety layers to completely eliminate trailing key dumps.

🛠️ Requirements

  • Zsh (Shell Core)
  • fzf (Interactive Engine)
  • fd (Discovery Engine)
  • zoxide (ctrl-z history warp transitions)
  • bat (Syntax highlighted text file previews)
  • eza (Structured folder tree generation)
  • chafa (Visual image/video terminal rendering)

📦 Installation

1. One Line

Run this command:

mkdir -p ~/.config/zsh && curl -fsSL https://raw.githubusercontent.com/claw-h/fuzzy-nav/main/fuzzy-nav.plugin.zsh -o ~/.config/zsh/fuzzy-nav.plugin.zsh && printf '\n# Symmetrical Fuzzy Navigation Engine\nsource ~/.config/zsh/fuzzy-nav.plugin.zsh\n' >> ~/.zshrc && source ~/.zshrc

2. Manual Installation

Clone it anywhere on your machine and source it manually inside ~/.zshrc:

git clone [https://raw.githubusercontent.com/claw-h/fuzzy-nav/main/fuzzy-nav.plugin.zsh](https://raw.githubusercontent.com/claw-h/fuzzy-nav/main/fuzzy-nav.plugin.zsh) ~/.config/zsh/plugins/fuzzy-nav
source ~/.config/zsh/plugins/fuzzy-nav/fuzzy-nav.plugin.zsh