Zum Inhalt springen
Trainingslager IT-Trainingslager

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

  • fzf liest 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 Vorschau bat und eza.
  • 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 | fzf

Tippe 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
done

Erwartet:

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 fzf

Erwartet:

"^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 atuin auf ⌥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 mit bindkey '^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
fbr

Tippe 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 &
fkill

Tippe 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-dev

Erwartet:

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
fkctx

Tippe 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 TODO

Tippe 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 compinit laden, aber vor Plugins, die Widgets umhüllen (zsh-autosuggestions, fast-syntax-highlighting). Die Lab-.zshrc lädt config/zsh/*.zsh alphabetisch nach compinit. 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
fkctx

Tippe prod, Enter, dann n:

Switched to context "lab-dev".
Wirklich nach lab-prod wechseln? [y/N] n
echo "rc=$?"; kubectl config current-context

Erwartet:

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.
  • KUBECONFIG pro Projekt setzen (direnv, Tag 14) statt eine riesige ~/.kube/config mit 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: …". Setze HIST_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).