new file mode 100644
index 0000000..eb9cac4
@@ -0,0 +1,20 @@
+---
+visibility: public
+---
+
+# fzf
+
+command-line fuzzy finder. used for everything — history search, file finding, directory jumping.
+
+**installed via:** `brew install fzf`
+
+**config:**
+```
+export FZF_DEFAULT_OPTS="--walker-root=$HOME --walker-skip=.git,node_modules,.cache,build,Library,Google\ Drive,.vscode,.lmstudio,.local,.beads,.claude,.Trash,.bun,.cursor,.warp,.cargo,.gemini"
+```
+
+the walker-skip list is tuned to avoid indexing noise directories that slow down search and pollute results.
+
+**custom function `ffhist`:** fuzzy-searches shell history and runs the selected command immediately.
+
+**part of the shell navigation stack:** fzf for interactive search, [[yazi]] for file browsing, [[zoxide]] for directory jumping, [[eza]] for listing. fzf is the glue — it can be piped into anything.
\ No newline at end of file