Tag 7: fzf überall
Ziel: Jede Liste im Terminal (Dateien, Verzeichnisse, History, Branches, Prozesse, Kontexte) mit einem Fuzzy Finder durchsuchen und eigene Picker bauen. · Dauer: ca. 75 min · Voraussetzung: Tag 6
Briefing
fzfliest Zeilen von stdin, du filterst interaktiv, die Auswahl geht nach stdout. Mehr ist es nicht.- Darum passt es überall dazwischen:
liste | fzf | befehl. - Mitgeliefert sind drei Key-Bindings (⌃T, ⌃R, ⌥C) und die Completion
**<Tab>. - Als Quelle nimmst du
fd(Tag 6), als Vorschaubatundeza. - Alles landet in einer Moduldatei:
~/term-lab/config/zsh/fzf.zsh.
fd / git / ps / kubectl ──stdin──▶ fzf ──stdout──▶ $EDITOR / git switch / kill
Quelle Auswahl Aktion
Drill 1: fzf als Filter in der Pipe
cd ~/term-lab/projekt
fd -t f | fzfTippe cart, wähle mit
⌃J/⌃K (oder Pfeiltasten), bestätige
mit Enter. Erwartet:
internal/cart/cart.go
Die Auswahl landet auf stdout. Also kannst du sie weiterreichen:
bat "$(fd -e yaml | fzf)"Die Suchsyntax ist mehr als „Buchstaben in Reihenfolge”. Mit
--filter testest du sie ohne Oberfläche:
fd -t f -H -E .git > /tmp/lab-files.txt
for q in "cmdgo" "'cart" "^config" ".yaml$" "yaml !deploy" "go$ | py$"; do
printf '%-14s -> ' "$q"; fzf --filter "$q" < /tmp/lab-files.txt | xargs
doneErwartet:
cmdgo -> cmd/shop/main.go
'cart -> internal/cart/cart.go
^config -> config/app.json config/app.yaml
.yaml$ -> config/app.yaml deploy/k8s/deployment.yaml
yaml !deploy -> config/app.yaml
go$ | py$ -> cmd/shop/main.go scripts/report.py internal/cart/cart.go
| Muster | Bedeutung | Merkhilfe |
|---|---|---|
cmdgo |
fuzzy: Buchstaben in dieser Reihenfolge | Standard |
'cart |
exakt dieser Text | Apostroph = wörtlich |
^config |
beginnt mit | wie Regex ^ |
.yaml$ |
endet mit | wie Regex $ |
!deploy |
enthält nicht | ! = nicht |
a b |
UND | Leerzeichen = und |
ODER schreibst du mit Pipe-Zeichen zwischen Leerzeichen:
go$ | py$.
Fortschritt speichern? Kostenlos registrieren
Drill 2: Konfiguration und ⌃T
Die Key-Bindings bringt fzf selbst mit (fzf --zsh, seit
Version 0.48). Dazu kommen fd als Quelle und eine Vorschau
mit bat:
cat > ~/term-lab/config/zsh/fzf.zsh <<'EOF'
# fzf.zsh – fzf überall (Tag 7)
(( $+commands[fzf] )) || return 0
# Key-Bindings ⌃T, ⌃R, ⌥C und **<Tab>-Completion (fzf >= 0.48)
source <(fzf --zsh)
# Quellen: fd statt find – schnell, respektiert .gitignore
export FZF_DEFAULT_COMMAND='fd --type f --hidden --exclude .git'
export FZF_DEFAULT_OPTS='--height 40% --layout reverse --border --info inline-right'
export FZF_CTRL_T_COMMAND=$FZF_DEFAULT_COMMAND
export FZF_CTRL_T_OPTS="--preview 'bat --color=always --style=numbers \
--line-range :100 {}' --bind 'ctrl-/:toggle-preview'"
export FZF_ALT_C_COMMAND='fd --type d --hidden --exclude .git'
export FZF_ALT_C_OPTS="--preview 'eza --tree --level=2 --color=always {}'"
export FZF_CTRL_R_OPTS="--preview 'echo {2..}' --preview-window down:3:wrap:hidden \
--bind '?:toggle-preview'"
# **<Tab> nutzt ebenfalls fd
_fzf_compgen_path() { fd --hidden --exclude .git . "$1"; }
_fzf_compgen_dir() { fd --type d --hidden --exclude .git . "$1"; }
EOF
reload
bindkey | rg fzfErwartet:
"^I" fzf-completion
"^R" fzf-history-widget
"^T" fzf-file-widget
"^[c" fzf-cd-widget
Jetzt tippe bat (mit Leerzeichen), dann
⌃T, dann deplo:
[lab] projekt % bat
╭───────────────────────────────────────────────────────────────────────╮
│ > deplo 1/10 (0) ╭────────────────────────────────╮ │
│ ─────────────────────────────────── │ 1 apiVersion: apps/v1 │ │
│ ▌ deploy/k8s/deployment.yaml │ 2 kind: Deployment │ │
│ │ 3 metadata: │ │
│ │ 4 name: shop │ │
Enter setzt den Pfad an die Cursorposition:
[lab] projekt % bat deploy/k8s/deployment.yaml
⌃/ blendet die Vorschau aus und ein. Mit Tab markierst du mehrere Dateien, alle landen dann in der Zeile.
Fortschritt speichern? Kostenlos registrieren
Drill 3: ⌃R für die History, ⌥C für Verzeichnisse
⌃R durchsucht die History fuzzy. Tippe
yq:
╭──────────────────────────────────────────────────────────────────────────╮
│ > yq 4/5 │
│ ──────────────────────────────────────────────────────────────────────── │
│ ▌ 50 a=$(jq .replicas config/app.json); b=$(yq .spec.replicas deploy/k8 │
│ 38 yq .database.host config/app.yaml │
- Enter übernimmt den Befehl in die Zeile, ausgeführt wird erst mit dem nächsten Enter.
- ⌃R im Picker schaltet zwischen „nach Relevanz” und „chronologisch” um.
- ? zeigt lange Befehle umbrochen in der Vorschau
(unsere
FZF_CTRL_R_OPTS).
Tipp: Tag 4 legt
atuinauf ⌥R. Legst du es doch auf ⌃R, gewinnt die Datei, die zuletzt geladen wird. Entscheide dich für ein Werkzeug pro Taste und prüfe mitbindkey '^R'.
⌥C springt per fzf in ein Unterverzeichnis. Das
braucht „Option als Meta” aus Tag 1. Tippe k8s:
│ > k8s 1/9 ╭──────────────────────────────╮
│ ───────────────────────────── │ deploy/k8s │
│ ▌ deploy/k8s/ │ └── deployment.yaml │
Erwartet nach Enter:
[lab] projekt % builtin cd -- /Users/du/term-lab/projekt/deploy/k8s
[lab] k8s %
Kommt statt fzf ein ç ins Terminal, sendet ⌥ noch kein
Meta (Tag 1). Ersatz: Esc, dann c.
Fortschritt speichern? Kostenlos registrieren
Drill 4: **<Tab> – fzf
in jedem Befehl
Zwei Sterne und Tab öffnen fzf für das aktuelle Argument. Der Befehl davor bestimmt, was angeboten wird:
cd ~/term-lab/projekt
bat cart**Drücke Tab direkt nach den Sternen:
│ > cart 2/19 (0) │
│ ─────────────────────────────────────────────────────────────────── │
│ ▌ ./internal/cart/cart.go │
│ ▌ ./internal/cart/ │
Erwartet nach Enter:
[lab] projekt % bat ./internal/cart/cart.go
Spezialfälle, die fzf von Haus aus kennt:
| Eingabe | Liste | Merkhilfe |
|---|---|---|
cd **<Tab> |
nur Verzeichnisse | cd will Ordner |
kill **<Tab> |
Prozesse (ps) |
kill will PIDs |
ssh **<Tab> |
Hosts aus ~/.ssh/config und
known_hosts |
ssh will Hosts |
export **<Tab>,
unset **<Tab> |
Umgebungsvariablen | Variablen |
Prozess beenden ohne PID-Suche:
sleep 600 &
kill **Tab drücken, sleep 600 tippen:
│ > sleep 600 142/536 (0) │
│ USER PID PPID STARTED TIME COMMAND │
│ ▌ du 3401 89549 8:44am 0:00.00 sleep 600 │
Erwartet nach zweimal Enter:
[lab] projekt % kill 3401
[1] + terminated sleep 600
Fortschritt speichern? Kostenlos registrieren
Drill 5: Eigene Picker – Git-Branch und Prozesse
Das Muster ist immer gleich: Liste erzeugen, fzf,
Ergebnis an einen Befehl geben. Ein Abbruch (Esc) liefert Exit-Code 130,
darum || return 1.
cat >> ~/term-lab/config/zsh/fzf.zsh <<'EOF'
# --- Eigene Picker ---------------------------------------------------------
# fbr – Git-Branch wählen und wechseln (lokal und remote)
fbr() {
local br
br=$(git branch --all --sort=-committerdate --format='%(refname:short)' |
grep -v HEAD |
fzf --prompt='branch> ' --preview 'git log --oneline --color=always -10 {}') \
|| return 1
git switch "${br#origin/}"
}
# fkill – Prozess(e) wählen (Tab für Mehrfachauswahl) und beenden
fkill() {
local pids
pids=$(ps -u "$USER" -o pid=,etime=,command= |
fzf --multi --prompt='kill> ' --accept-nth=1) || return 1
print -r -- "kill ${1:--TERM} ${(f)pids}"
kill "${1:--TERM}" ${(f)pids}
}
EOF
reload
fbrTippe rab:
│ branch> rab 1/2 ╭──────────────────────────────────────╮ │
│ ──────────────────────────── │ 375fbf7 feat: Rabatt-Schalter │ │
│ ▌ feature/rabatt │ 2e4e6aa chore: Config, Manifeste, Re │ │
│ │ a57983c feat: Warenkorb und HTTP-Ser │ │
Erwartet nach Enter:
Zu Branch 'feature/rabatt' gewechselt
Zurück mit git switch main. ${br#origin/}
schneidet das Remote-Präfix ab. So legt git switch für
einen Remote-Branch automatisch einen lokalen Tracking-Branch an.
Jetzt zwei Prozesse auf einmal beenden:
sleep 701 & sleep 702 &
fkillTippe sleep 70, markiere beide Zeilen mit
Tab, dann Enter:
│ kill> sleep 70 89/380 (2) │
│ ▌┃ 5652 00:00 sleep 701 │
│ ▌┃ 5654 00:00 sleep 702 │
Erwartet (gekürzt):
kill -TERM 5652 5654
[1] - terminated sleep 701
[2] + terminated sleep 702
--accept-nth=1 gibt nur die erste Spalte (PID) zurück.
Das gibt es seit fzf 0.60. Ältere Versionen brauchen
| awk '{print $1}'. fkill -9 schickt SIGKILL,
nur als letzte Wahl.
Fortschritt speichern? Kostenlos registrieren
Drill 6: Kubernetes-Kontext per Picker
Dafür brauchst du keinen Cluster. Eine Lab-kubeconfig mit drei
Kontexten reicht, deine echte ~/.kube/config bleibt
unberührt:
export KUBECONFIG=~/term-lab/kube/config
mkdir -p ~/term-lab/kube
kubectl config set-cluster lab --server=https://127.0.0.1:6443 >/dev/null
for c in lab-dev lab-staging lab-prod; do
kubectl config set-context $c --cluster=lab --user=lab --namespace=webshop
done
kubectl config use-context lab-devErwartet:
Context "lab-dev" created.
Context "lab-staging" created.
Context "lab-prod" created.
Switched to context "lab-dev".
Der Picker zeigt den aktiven Kontext im Header:
cat >> ~/term-lab/config/zsh/fzf.zsh <<'EOF'
# fkctx – Kubernetes-Kontext wählen (zeigt den aktiven Kontext im Header)
fkctx() {
local ctx
ctx=$(kubectl config get-contexts -o name |
fzf --prompt='context> ' \
--header "aktiv: $(kubectl config current-context 2>/dev/null)") \
|| return 1
kubectl config use-context "$ctx"
}
EOF
reload
export KUBECONFIG=~/term-lab/kube/config
fkctxTippe prod:
│ context> prod 1/3 │
│ ──────────────────────────────────────────────────────────────────────── │
│ aktiv: lab-dev │
│ ▌ lab-prod │
Erwartet nach Enter:
Switched to context "lab-prod".
kubectx ohne Argument macht dasselbe, sobald fzf
installiert ist. kubens wählt so den Namespace. Den eigenen
Picker brauchst du, wenn du mehr willst, etwa eine Rückfrage bei
*prod* (Challenge).
Fortschritt speichern? Kostenlos registrieren
Drill 7: frg – suchen, wählen, an der Zeile öffnen
rg findet, fzf wählt, der Editor springt an die
Trefferzeile. --delimiter : zerlegt
datei:zeile:text in Felder, die Vorschau scrollt mit
+{2}/2 zur Zeile:
cat >> ~/term-lab/config/zsh/fzf.zsh <<'EOF'
# frg – Text mit rg suchen, Treffer wählen, im Editor an der Zeile öffnen
frg() {
[[ -n $1 ]] || { print -u2 "usage: frg <muster>"; return 2; }
local hit
hit=$(rg --line-number --no-heading --color=always -- "$1" |
fzf --ansi --delimiter : --prompt='rg> ' --height 80% \
--preview 'bat --color=always --highlight-line {2} {1}' \
--preview-window 'down,60%,+{2}/2') || return 1
${EDITOR:-vi} "+${${hit#*:}%%:*}" "${hit%%:*}"
}
EOF
reload
EDITOR=echo frg TODOTippe rabatt:
│ rg> rabatt 1/3 │
│ ──────────────────────────────────────────────────────────────────────── │
│ ▌ internal/cart/cart.go:16: // TODO: Rabatte berücksichtigen │
│ ╭──────────────────────────────────────────────────────────────────────╮ │
│ │ 10 │ // Total summiert alle Positionen. │ │
Erwartet nach Enter (EDITOR=echo zeigt nur, was der
Editor bekäme):
+16 internal/cart/cart.go
Ohne EDITOR=echo öffnet sich Neovim direkt in Zeile 16.
Ab Tag 11 ist $EDITOR der Lab-Wrapper nv,
frg nutzt ihn automatisch. ${hit%%:*} ist
alles vor dem ersten Doppelpunkt, ${${hit#*:}%%:*} das Feld
dazwischen.
Fortschritt speichern? Kostenlos registrieren
Drill 8: fzf-tab – jede Completion als Fuzzy-Liste
**<Tab> ist gut, aber zsh kennt viel mehr
Completions: Git-Branches, kubectl-Ressourcen, Optionen.
Das Plugin fzf-tab legt fzf über jede Tab-Completion.
Es ist ein Git-Repo, kein Homebrew-Paket:
git clone -q --depth 1 https://github.com/Aloxaf/fzf-tab \
~/term-lab/plugins/fzf-tab
cat >> ~/term-lab/config/zsh/fzf.zsh <<'EOF'
# --- fzf-tab (optional): zsh-Completion-Menü durch fzf ersetzen -------------
# Installation: git clone --depth 1 https://github.com/Aloxaf/fzf-tab \
# "$LAB/plugins/fzf-tab" – muss NACH compinit geladen werden.
if [[ -r $LAB/plugins/fzf-tab/fzf-tab.plugin.zsh ]]; then
source "$LAB/plugins/fzf-tab/fzf-tab.plugin.zsh"
zstyle ':completion:*' menu no
zstyle ':completion:*:descriptions' format '[%d]'
zstyle ':fzf-tab:complete:cd:*' fzf-preview 'eza -1 --color=always $realpath'
zstyle ':fzf-tab:*' switch-group '<' '>'
fi
EOF
reload
bindkey '^I'Erwartet:
"^I" fzf-tab-complete
Tippe git switch und Tab:
[lab] projekt % git switch
>
2/2 (0) ──────────────────────────────────────────────────────────
▌ feature/rabatt
▌ main
cd plus Tab zeigt die Ordner mit
eza-Vorschau. **<Tab> funktioniert
weiterhin.
Die fertige fzf.zsh mit allen Pickern (und der Lösung
der Challenge) liegt unter $BUCH/zsh/fzf.zsh.
Achtung: fzf-tab muss nach
compinitladen, aber vor Plugins, die Widgets umhüllen (zsh-autosuggestions, fast-syntax-highlighting). Die Lab-.zshrclädtconfig/zsh/*.zshalphabetisch nachcompinit. Das passt.
Fortschritt speichern? Kostenlos registrieren
Shortcut-Tabelle
| Taste | Wirkung | Merkhilfe |
|---|---|---|
| ⌃T | Datei(en) wählen und in die Zeile setzen | Take file |
| ⌃R | History fuzzy durchsuchen | Reverse search |
| ⌥C | in Unterverzeichnis wechseln | Change dir |
** Tab |
fzf für das aktuelle Argument | zwei Sterne = alles |
| ⌃J / ⌃K | in der Liste runter / hoch | vim j/k mit ⌃ |
| Tab / ⇧Tab | Eintrag markieren / Markierung weg | mehrere wählen |
| ⌃/ | Vorschau ein/aus (unsere Konfig) | Slash = Fenster teilen |
| Esc, ⌃C | abbrechen (Exit-Code 130) | raus |
Kontrollpunkt
cd ~/term-lab/projekt
c() { eval "$2" >/dev/null 2>&1 && echo "✔ $1" || echo "✘ $1"; }
c "⌃T gebunden" '[[ $(bindkey "^T") == *fzf-file-widget ]]'
c "⌃R gebunden" '[[ $(bindkey "^R") == *fzf-history-widget ]]'
c "⌥C gebunden" '[[ $(bindkey "^[c") == *fzf-cd-widget ]]'
c "Quelle ist fd" '[[ $FZF_DEFAULT_COMMAND == fd* ]]'
c "Vorschau mit bat" '[[ $FZF_CTRL_T_OPTS == *bat* ]]'
c "Picker vorhanden" 'whence fbr fkill fkctx frg'
c "Suchsyntax" '[[ $(fd -e go | fzf --filter "^int") == */cart.go ]]'
c "Lab-kubeconfig" '[[ $KUBECONFIG == *term-lab/kube/config ]]'
c "fzf-tab (optional)" '[[ $(bindkey "^I") == *fzf-tab-complete ]]'Erwartet: lauter ✔. Steht bei Lab-kubeconfig ein ✘,
fehlt in dieser Shell nur das
export KUBECONFIG=~/term-lab/kube/config aus Drill 6.
Challenge
Erweitere fkctx: Enthält der gewählte Kontext
prod, fragt die Funktion vor dem Wechsel nach. Bei „n”
bleibt der alte Kontext aktiv und der Exit-Code ist 1.
Hinweis: Muster aus please (Tag 5):
read -q "?Frage ".
Lösung
cat >> ~/term-lab/config/zsh/fzf.zsh <<'EOF'
# fkctx mit Rückfrage für Produktion (überschreibt die Version aus Drill 6)
fkctx() {
local ctx
ctx=$(kubectl config get-contexts -o name |
fzf --prompt='context> ' \
--header "aktiv: $(kubectl config current-context 2>/dev/null)") \
|| return 1
if [[ $ctx == *prod* ]]; then
read -q "?Wirklich nach $ctx wechseln? [y/N] " || { print; return 1; }
print
fi
kubectl config use-context "$ctx"
}
EOF
reload
export KUBECONFIG=~/term-lab/kube/config
kubectl config use-context lab-dev
fkctxTippe prod, Enter, dann n:
Switched to context "lab-dev".
Wirklich nach lab-prod wechseln? [y/N] n
echo "rc=$?"; kubectl config current-contextErwartet:
rc=1
lab-dev
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Picker für gefährliche Ziele (prod-Kontexte,
kill,git push --force) immer mit Rückfrage oder farbigem Header bauen. Ein Tippfehler im Fuzzy-Match ist schnell passiert. KUBECONFIGpro Projekt setzen (direnv, Tag 14) statt eine riesige~/.kube/configmit allen Kunden zu pflegen.- fzf führt Vorschau-Befehle in einer Shell aus. Dateinamen aus
fremden Repos immer über die Platzhalter
{}einsetzen lassen, fzf quotet sie. Nie selbst in Strings zusammenbauen. - Die ⌃R-History enthält oft Tokens aus
curl -H "Authorization: …". SetzeHIST_IGNORE_SPACE(Tag 4) und tippe solche Befehle mit führendem Leerzeichen. - fzf-tab und andere Plugins sind fremder Code in deiner Shell: auf einen Commit pinnen und Updates bewusst einspielen (Tag 13).