MrTechKing

4 min read

fzf: Fuzzy Search Your Files and Command History (GitHub, Scanned)

A free fuzzy finder for the terminal: type a few letters to find any file, past command or folder in milliseconds.

fzf logo
✅
Scan: safe. Nothing to warn about. No secrets or suspicious code, the program does not go online, and the three advisories are minor ones in Go libraries. Scanned Nov 16, 2026; the full report is below.

fzf is a free fuzzy finder for the command line. You give it any list, such as file names, your command history or git branches, and it opens an interactive picker where you type a few letters in any order and the best matches rise to the top. Once its shell integration is on, three keys change how you use the terminal: Ctrl-R searches your history, Ctrl-T pastes a file path, and Alt-C jumps into a folder.

It earns its place because it is one small, fast program that plugs into almost everything. It ships key bindings and fuzzy completion for bash, zsh, fish and Nushell, a plugin for Vim and Neovim, and a preview window that shows a file's contents as you move through the list. Many other terminal tools and scripts use it as their picker, so learning it once pays off everywhere.

fzf is MIT-licensed and written in Go by Junegunn Choi, who started it in 2013. It has about 84,000 stars and around 340 contributors. Version 0.75.0 came out on 7 November 2026.

  • Repository: github.com/junegunn/fzf
  • Licence: MIT (MIT License)
  • Language: Go. Stars: 84.2K. Forks: 3,482. Last push: Nov 12, 2026.
  • Scan: safe, Nov 16, 2026, commit 4499615

Who it is for

Developers, sysadmins, data people and anyone who retypes long commands or hunts for files in a terminal. It works on macOS, Linux and Windows; you need to be comfortable adding a line to your shell config.

Getting started

1. Install on macOS or Linux with Homebrew

brew install fzf

2. Or on Windows, with winget

winget install fzf

3. Turn on the key bindings and completion for zsh (for bash, add eval "$(fzf --bash)" to ~/.bashrc)

echo 'source <(fzf --zsh)' >> ~/.zshrc

4. Open a new terminal and pick a file below the current folder; Ctrl-R now searches your history

fzf

5. Preview each file as you move through the list

fzf --preview 'cat {}'

Package managers do not change your shell files; the line you add does. If you install from a git clone instead, ~/.fzf/install asks before adding lines to ~/.bashrc or ~/.zshrc, and ~/.fzf/uninstall takes them out again. Our scan covers the source code, not the prebuilt binaries.

Safety scan

We cloned junegunn/fzf at commit 4499615 on Nov 16, 2026 and ran the checks described on the GitHub Tools page: credential patterns, decode-and-execute code, install-time scripts, committed binaries, risky CI workflows, every host the code talks to, known vulnerabilities in pinned dependencies, and project hygiene. A person read every hit. This is what we found.

  • 0 secret hits and no committed binaries across 164 files and about 52,000 lines, mostly Go, with Ruby tests and the shell integration scripts.
  • 0 pattern hits. The --listen option starts a small web server so scripts can control fzf, but only when you pass it; it binds to localhost and refuses remote connections unless you set an API key in FZF_API_KEY.
  • The install script downloads the release binary from GitHub with curl or wget, or builds it with Go, then asks whether to enable key bindings and completion and whether to add lines to your ~/.bashrc or ~/.zshrc. It does not use sudo, and the uninstall script removes those lines.
  • 3 advisories with no severity rating, all in Go libraries built into fzf: golang.org/x/sys, an integer overflow in a Windows-only function, and golang.org/x/text, two bugs triggered by crafted text input. None is rated high or critical.
  • The program contacts no server; the hosts in the code are documentation links and GitHub. Eight workflows, with CodeQL, dependency review, Dependabot and a security policy. One uses pull_request_target only to label pull requests, without checking out their code. 4 of 5 third-party actions are pinned to commits. OpenSSF Scorecard gives it 6.5 out of 10.

What the scanner counted

CheckResult
SecretsNone found.
Suspicious codeNone found.
Install-time code1 installer script
Committed binariesNone.
CI workflows8 workflows. 1 uses pull_request_target, none check out the pull request head. 1 of 5 third-party actions pinned to a tag rather than a commit.
Network hosts19 distinct hosts referenced from source; most often github.com, ascii-table.com, docs.microsoft.com, en.wikipedia.org. No URLs to bare IP addresses.
Known vulnerabilities3 advisories across 11 pinned packages: 0 critical, 0 high, 0 moderate, 0 low, 3 unrated. go.mod: 11 packages, 3 advisories.
Project hygieneHas security policy, automated dependency updates, CodeQL, licence file. Missing contributing guide.
OpenSSF Scorecard6.5 out of 10, as of Oct 26, 2026.

The raw findings

Every hit the scanner wrote out, with a link to the exact line at the scanned commit. Secrets candidates are redacted.

Installer scripts (1)
Worst known vulnerabilities (3 of 3)
AdvisorySeverityPackageSummary
CVE-2026-39824unknowngolang.org/x/sys@0.35.0Invoking integer overflow in NewNTUnicodeString in golang.org/x/sys/windows
CVE-2026-56852unknowngolang.org/x/text@0.28.0Infinite loop on invalid input in golang.org/x/text
CVE-2026-56851unknowngolang.org/x/text@0.28.0Panic parsing crafted input in x/text/secure/precis in golang.org/x/text
Workflows worth a look

By the numbers

Stars84.2K
Forks3,482
Contributors340
Commits3,771
Open issues271
Open pull requests62
Releases87
Latest releasev0.75.0
LicenceMIT
Main languageGo
Project age13 years
Last pushNov 12, 2026
Tracked files164
Lines of code52.2K
Checkout size2 MB

Lines by language: Go 34.5K, Ruby 8,786, Markdown 6,252, Shell 1,876, YAML 720, PowerShell 66.

Questions

Is fzf free?

Yes. It is free and open source under the MIT licence. The README links optional fzf merchandise and GitHub Sponsors.

Does fzf work on Windows?

Yes. Install it with winget, Scoop or Chocolatey and use it as a picker in any terminal. The ready-made Ctrl-R and Ctrl-T bindings are for bash, zsh, fish and Nushell, so on Windows you get them in WSL, Git Bash or Nushell.

Does fzf send my data anywhere?

No. It reads the list you give it and prints what you pick. The only network code is the optional --listen server, which stays on your own machine unless you set an API key.

Do I need to know how to code?

No, but you need a terminal. Installing it and turning on the key bindings takes two commands. Building your own pickers with it takes a little shell scripting.

How do I uninstall fzf?

Remove the fzf line from your shell config, then run brew uninstall fzf or winget uninstall fzf. If you used the git install, run ~/.fzf/uninstall and delete the ~/.fzf folder.


This post is part of GitHub Tools, where every repository is cloned and scanned before it is written up. The scan is a snapshot of one commit on one day; the repository has moved on since, so check it before you install.