CI License: MIT

A powerful interactive file search and navigation tool using fzf. Seamlessly switch between file finding (by name) and content searching (by text) modes for fast and intuitive file exploration and editing.

• 🔄 Dual Mode Operation: Instantly switch between Find mode and Grep mode with a single TAB keypress
• 👀 Live Preview: Real-time file content preview with syntax highlighting
• 🎨 Syntax Highlighting: Beautiful code display using bat/batcat
• 🌳 Directory Trees: Visual directory structure using eza or tree
• ⚡ Lightning Fast: High-speed searching with fd and ripgrep
• 📝 Editor Integration: Direct file opening in VSCode or your preferred editor
• 🎯 Jump to Line: Navigate directly to matched lines in Grep mode
• 🔧 Smart Fallbacks: Works with standard Unix tools when optional dependencies aren't available
• 🎨 Beautiful UI: Polished interface with icons, colors, and intuitive controls

• fzf - Interactive fuzzy finder (core dependency)
• Supported Shells: Bash, Zsh, Fish

Install these for the best experience:

Note: To see icons in directory trees when using eza, you need to install a Nerd Font. Popular choices include:

• JetBrains Mono Nerd Font
• Fira Code Nerd Font
• Hack Nerd Font

After installation, configure your terminal to use the Nerd Font.

brew install fzf fd ripgrep bat eza tree

sudo apt update
sudo apt install fzf fd-find ripgrep bat eza tree

curl -fsSL https://raw.githubusercontent.com/the0807/ff/main/install.sh | bash

Then reload your shell:

source ~/.zshrc # for zsh users
source ~/.bashrc # for bash users
source ~/.config/fish/config.fish # for fish users

1. Download the script:

For Bash/Zsh:

mkdir -p ~/.config/ff
curl -fsSL https://raw.githubusercontent.com/the0807/ff/main/ff.sh -o ~/.config/ff/ff.sh

For Fish:

mkdir -p ~/.config/ff
curl -fsSL https://raw.githubusercontent.com/the0807/ff/main/ff.fish -o ~/.config/ff/ff.fish

2. Add to your shell configuration:

For Zsh (~/.zshrc):

echo 'source ~/.config/ff/ff.sh' >> ~/.zshrc
source ~/.zshrc

For Bash (~/.bashrc or ~/.bash_profile on macOS):

echo 'source ~/.config/ff/ff.sh' >> ~/.bashrc
source ~/.bashrc

For Fish (~/.config/fish/config.fish):

echo 'source ~/.config/ff/ff.fish' >> ~/.config/fish/config.fish
source ~/.config/fish/config.fish

If you installed ff using the quick install method, the uninstaller is already available locally:

bash ~/.config/ff/uninstall.sh

If the local uninstaller is not available, you can download it:

# Download and run the uninstaller
curl -fsSL https://raw.githubusercontent.com/the0807/ff/main/uninstall.sh -o /tmp/uninstall-ff.sh
bash /tmp/uninstall-ff.sh

The uninstaller will:

• Remove ~/.config/ff/ directory
• Clean up shell configuration files (.zshrc, .bashrc, config.fish)
• Create backups before modifying any files

ff # Start in Find mode (default)
ff find # Start in Find mode (explicit)
ff grep # Start in Grep mode

• Type to fuzzy search by filename
• Press Enter to navigate to the selected file's directory
• Press Ctrl-O to open the file in your editor

• Type to search by file content
• See matching files with line numbers and context
• Press Enter to navigate to the file's directory
• Press Ctrl-O to open the file at the matched line

$ ff
# Type "config" to fuzzy find files matching "config"
# Use arrow keys to select
# Press Enter to cd to the file's directory
# Or press Ctrl-O to open the file

$ ff grep
# Type "function handleClick"
# See all files containing this text
# Files show with line numbers highlighted
# Press Ctrl-O to open in editor at that exact line

$ ff
# Start browsing files in Find mode
# Type "README" to find README files
# Press TAB to switch to Grep mode
# Type "installation" to search content
# Press TAB again to return to Find mode

$ ff find
# Search for "utils.js"
# Press Enter to cd to the directory
$ pwd # You're now in the file's directory

By default, ff uses VSCode (code) if available, otherwise falls back to $EDITOR. To customize:

# Add to ~/.zshrc or ~/.bashrc
export EDITOR=nvim # Neovim
# or
export EDITOR=vim # Vim
# or
export EDITOR=nano # Nano

Edit the ff.sh file to customize:

• FZF options (layout, theme, colors)
• Preview window size and position
• Key bindings
• Search commands

1. Uses fd (or find) to list all files and directories
2. Pipes results to fzf for interactive filtering
3. Shows file previews using bat (with syntax highlighting)
4. Shows directory trees using eza or tree

1. Uses ripgrep (or grep) to search file contents as you type
2. Results show filename, line number, and matched content
3. Preview highlights the matched line in context
4. Opening with Ctrl-O jumps directly to the matched line

# Check if fzf is installed
which fzf
# If not installed, install it:
# macOS
brew install fzf
# Ubuntu/Debian
sudo apt install fzf

Install the optional tools for better previews:

# macOS
brew install bat eza tree
# Ubuntu/Debian
sudo apt install bat eza tree

Check your EDITOR environment variable:

echo $EDITOR
# If empty or not your preferred editor, set it:
export EDITOR=vim # or your preferred editor

Ensure VSCode command-line tools are installed:

1. Open VSCode
2. Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Linux/Windows)
3. Type "Shell Command: Install 'code' command in PATH"
4. Select it and restart your terminal

Contributions are welcome! Feel free to:

• 🐛 Report bugs by opening an issue
• 💡 Suggest new features
• 🔧 Submit pull requests
• 📖 Improve documentation

MIT License - Feel free to use, modify, and distribute.

This project is built on top of these excellent tools:

• fzf - Command-line fuzzy finder
• fd - Fast and user-friendly alternative to find
• ripgrep - Recursively search directories for regex patterns
• bat - Cat clone with syntax highlighting
• eza - Modern replacement for ls

# From anywhere in your project
ff
# Type the filename you want to work on
# Press Enter to navigate there
# Your shell is now in that directory!

ff grep
# Type "TODO"
# See all TODO comments across your codebase
# Press Ctrl-O to open and fix them

ff
# Type "config"
# Quickly find all configuration files

ff grep
# Type "function myFunction"
# Find where functions are defined
# Jump directly to the definition

ff is designed to be fast even in large codebases:

• With fd and ripgrep: Handles repositories with 100,000+ files efficiently
• Real-time search results as you type
• Minimal memory footprint
• Works great on both small and large projects

Happy file browsing! 🚀