FZY(1)

💖 fzy — the fuzzy text selector menu for the terminal, bestie 💖

okay so this is the fzy(1) page from the General Commands Manual, and honestly? she's iconic. sit down, grab a boba, we're doing this. 🧋✨

---

🌸 NAME 🌸

fzy — a fuzzy text selector menu for the terminal. that's it. that's the girl. 💅

---

✨ SYNOPSIS ✨

fzy [OPTION]...

---

🦋 DESCRIPTION 🦋

so fzy is a fuzzy text selector / file finder for the terminal, and she uses a search similar to that of TextMate or CmdT. iykyk.

here's the whole vibe:

• fzy reads a list of newline-separated items from stdin and displays them as a menu in the terminal. 🌈
• the moment you hit ENTER, the currently selected item gets printed to stdout. slay.
• typing text narrows the items down using fuzzy matching ✨
• and the results are sorted using heuristics for the best match. she's picking the winner for you. 👑

---

🎀 OPTIONS 🎀

• -l, --lines=LINES — how many lines of items to show. if you don't say anything, she defaults to 10 lines.
• -p, --prompt=PROMPT — the input prompt (default: > ).
• -s, --show-scores — show the scores for each item. numbers! for the girlies who like receipts. 📊
• -t, --tty=TTY — use TTY instead of the default tty device (/dev/tty).
• -q, --query=QUERY — use QUERY as the initial search query. pre-typed, pre-cute. 💅
• -e, --show-matches=QUERY — non-interactive mode. print the matches in sorted order for QUERY to stdout. no menu, no waiting, just results.
• -0, --read-null — read input delimited by ASCII NUL characters. for the filename girlies with the weird names. 🫶
• -i, --show-info — show the selection info line.
• -h, --help — usage help.
• -v, --version — usage help. (yes bestie, the original page says usage help here too, and i am not the one who's gonna lie to you about it. 🙈)

---

👑 KEYS 👑

here's your keyboard cheat sheet, memorize it, put it on a sticky note:

• ENTER — print the selected item to stdout and exit. main character moment. 💖
• Ctrl+c, Ctrl+g, Esc — exit with status 1, without making a selection. 😭 no pick, no glory.
• Up Arrow, Ctrl+p, Ctrl+k — select the previous item.
• Down Arrow, Ctrl+n, Ctrl+j — select the next item.
• Tab — replace the current search string with the selected item.
• Backspace, Ctrl+h — delete the character before the cursor.
• Ctrl+w — delete the word before the cursor.
• Ctrl+u — delete the entire line.

---

🌈 USAGE EXAMPLES 🌈

these are the moments where she ate, fr fr:

ls | fzy

present a menu of items in the current directory. starter pack. ⭐

ls | fzy -l 25

same as above, but show 25 lines of items. more to look at, more to love. 🍓

vi $(find -type f | fzy)

list files under the current directory and open the one selected in vi.

cd $(find -type d | fzy)

present all directories under current path, and change to the one selected.

ps aux | fzy | awk '{ print $2 }' | xargs kill

list running processes, kill the selected process. 💀 dramatic but effective.

git checkout $(git branch | cut -c 3- | fzy)

same as above, but switching git branches. 🦋

---

💜 AUTHOR 💜

John Hawthorn <john.hawthorn@gmail.com>

---

no cap: every flag, every key, every example above is exactly as the original says. i just made it cute. 🫶

---

and that's the whole page, bestie!! this is fzy 1.1, dated 2025-07-12, and it lives in the FZY(1) manual. go fuzzy-match something and feel like the main character you are. ✨💖🎀🌸🦋💅