pf logopf

Fast Terminal Folder Picker

Navigate directories instantly with arrow keys and live fuzzy search. Just type to filter, press Tab to cd.

~/Dev
$ pf
Filter: web
pm7-Terminal/
pm7-Tools/
▸ pm7-web-app/
pm7-website/
winfakt-webapp/
↑↓ navigate Tab select Esc back F1 help

Installation

🍺 Homebrew

brew tap patrickmast/pf
brew install pf
pf --install
source ~/.zshrc

🐹 Go install

go install github.com/patrickmast/pf@latest
pf --install
source ~/.zshrc

Features

⚡

Instant Navigation

Use arrow keys to navigate. Enter goes into folders, Esc goes back to parent.

🔍

Fuzzy Search

Just start typing to filter. Multiple words match independently for precise results.

⌨️

Tab to cd

Press Tab to select a folder and immediately cd into it. No more typing long paths.

🎯

Multi-word Filter

Type 'my proj' to match folders containing both 'my' AND 'proj' in any order.

📁

Tree View

See your folder structure at a glance. Hidden folders are automatically excluded.

🚀

Lightweight

Single binary, no dependencies. Built with Go for maximum performance.

Keyboard Shortcuts

↑ / ↓Navigate list
EnterOpen folder
TabSelect folder & cd to it
EscGo to parent folder
BackspaceClear filter character
Ctrl+CQuit without selecting
F1Show help