Tag 4: History-Meisterschaft
Ziel: Jeder Befehl, den du je getippt hast, ist in zwei Sekunden wieder da – gefiltert nach Text, Verzeichnis oder Exit-Code. · Dauer: ca. 75 min · Voraussetzung: Tag 3
Briefing
- Die History ist dein persönliches Runbook. Senior Engineers tippen lange Befehle selten zweimal, sie suchen sie.
- Standard auf dem Mac: 2000 Einträge im Speicher, 1000 in der Datei, ohne Zeitstempel. Das ist zu wenig.
- Drei Suchstufen: ↑ mit Präfix, ⌃R (eingebaut oder mit fzf), atuin (SQLite-Datenbank mit Verzeichnis, Exit-Code und Dauer).
- Secrets gehören nicht in die History. Ein Leerzeichen vor dem Befehl hält ihn draußen.
Tippen ──► zsh-History (~/term-lab/zsh/.zsh_history) ◄── ↑, ⌃R (fzf)
└─► atuin-DB (~/term-lab/data/atuin/history.db) ◄── ⌥R
+ Verzeichnis, Exit-Code, Dauer, Session
Drill 1: Die History richtig einstellen
echo $HISTFILE $HISTSIZE $SAVEHISTErwartet (vor dem Drill):
/Users/du/term-lab/zsh/.zsh_history 2000 1000
Diese Werte setzt /etc/zshrc. Jetzt die eigene
Datei:
cat > ~/term-lab/config/zsh/history.zsh <<'EOF'
# ~/term-lab/config/zsh/history.zsh – History (Tag 4)
HISTFILE=$ZDOTDIR/.zsh_history
HISTSIZE=100000
SAVEHIST=100000
setopt EXTENDED_HISTORY # Zeitstempel und Dauer speichern
setopt SHARE_HISTORY # sofort schreiben, zwischen Shells teilen
setopt HIST_IGNORE_SPACE # " befehl" landet nicht in der History
setopt HIST_IGNORE_ALL_DUPS # ältere Duplikate entfernen
setopt HIST_REDUCE_BLANKS # überflüssige Leerzeichen weg
setopt HIST_VERIFY # !! erst zeigen, dann mit ⏎ ausführen
# ↑ / ↓ suchen nach dem, was schon getippt ist
autoload -Uz up-line-or-beginning-search down-line-or-beginning-search
zle -N up-line-or-beginning-search
zle -N down-line-or-beginning-search
for k in '^[[A' '^[OA'; do bindkey -M emacs $k up-line-or-beginning-search; done
for k in '^[[B' '^[OB'; do bindkey -M emacs $k down-line-or-beginning-search; done
EOF
exec ~/term-lab/lab
echo $HISTSIZE $SAVEHIST
setopt | grep histErwartet:
100000 100000
extendedhistory
histignorealldups
histignorespace
histreduceblanks
histverify
sharehistory
| Option | Warum |
|---|---|
SHARE_HISTORY |
Befehl aus Tab 1 ist in Tab 2 sofort per ↑ da, auch in tmux-Panes |
HIST_IGNORE_ALL_DUPS |
git status steht nur einmal drin, nämlich zuletzt |
HIST_VERIFY |
sudo !! zeigt erst den fertigen Befehl, ein zweites ⏎
führt aus |
EXTENDED_HISTORY |
jede Zeile mit Startzeit und Dauer |
Fortschritt speichern? Kostenlos registrieren
Drill 2: Was steht in der Datei?
Tippe im Projekt ein paar Befehle, der vierte beginnt mit einem Leerzeichen:
cd ~/term-lab/projekt
git status --short
wc -l logs/app.log
export API_TOKEN=sk-lab-geheim-1234
grep ERROR logs/app.log | wc -l
tail -4 $HISTFILEErwartet (deine Zeitstempel weichen ab):
: 1791615295:0;git status --short
: 1791615296:0;wc -l logs/app.log
: 1791615297:0;grep ERROR logs/app.log | wc -l
: 1791615299:0;tail -4 $HISTFILE
Format:
: <Startzeit in Unix-Sekunden>:<Dauer>;<Befehl>.
Der export mit dem Lab-Token fehlt, und die doppelten
Leerzeichen im grep sind weg.
Sicherheit:
HIST_IGNORE_SPACEist ein Sicherheitsnetz, kein Tresor. Der Befehl bleibt bis zum nächsten Befehl per ↑ abrufbar und steht in der Prozessliste. Echte Tokens liest du aus einer Datei, einem Passwort-Manager oder perread -s.
Fortschritt speichern? Kostenlos registrieren
Drill 3: ↑ mit Präfix
Tippe nur git und drücke ↑:
[lab] projekt % git status --short▮
Ohne Präfix blättert ↑ wie gewohnt durch alles. Mit Präfix nur durch Befehle, die so anfangen. Weiter zurück geht es mit erneutem ↑. Das allein ersetzt viele ⌃R-Suchen.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Eingebaute Suche und
fc
Erst die Bordmittel, denn die gibt es auf jedem Server. Drücke
⌃R und tippe ERR:
grep ERROR logs/app.log | wc -l
bck-i-search: ERR_
Noch einmal ⌃R springt zum nächstälteren Treffer.
⏎ führt aus, ⌃E oder → übernimmt
die Zeile zum Bearbeiten, ⌃G bricht ab.
Für Listen ist fc da. history ist dasselbe
wie fc -l:
history -i -3
fc -l -m 'git*' 1Erwartet (gekürzt, deine Nummern und Zeiten weichen ab):
5 2026-10-10 08:55 wc -l logs/app.log
6 2026-10-10 08:55 grep ERROR logs/app.log | wc -l
7 2026-10-10 08:56 tail -4 $HISTFILE
1 git status --short
-i zeigt Datum und Uhrzeit, -m filtert per
Glob, die 1 heißt „ab Eintrag 1”. Zwei weitere Kniffe:
| Befehl | Wirkung |
|---|---|
r |
letzten Befehl wiederholen |
r wc |
letzten Befehl wiederholen, der mit wc beginnt |
fc |
letzten Befehl im $EDITOR öffnen, nach :wq
ausführen |
fc -l -20 |
die letzten 20 Befehle |
Fortschritt speichern? Kostenlos registrieren
Drill 5: fzf für ⌃R
fzf macht aus ⌃R eine unscharfe Suche mit Liste. Du tippst Wortfetzen in beliebiger Reihenfolge, fzf findet die Zeile.
cat > ~/term-lab/config/zsh/fzf.zsh <<'EOF'
# ~/term-lab/config/zsh/fzf.zsh – fzf-Grundlage (Tag 4, Ausbau an Tag 7)
# ⌃R History, ⌃T Dateien, ⌥C Verzeichnis wechseln
source <(fzf --zsh)
export FZF_CTRL_R_OPTS="--height 40% --layout reverse --info inline"
EOF
exec ~/term-lab/lab
for k in '^R' '^T' '^[c'; do bindkey $k; doneErwartet:
"^R" fzf-history-widget
"^T" fzf-file-widget
"^[c" fzf-cd-widget
Jetzt ⌃R und log wc tippen. Ungefähr so
sieht es aus (Darstellung kann je nach Version abweichen):
> log wc
3/9 ──────────────────────────────────────
> grep ERROR logs/app.log | wc -l
wc -l logs/app.log
⏎ übernimmt die Zeile in den Prompt, ausgeführt wird
erst mit einem weiteren ⏎. Im fzf-Fenster:
| Taste | Wirkung |
|---|---|
⌃J / ⌃K oder ↓ /
↑ |
Auswahl bewegen |
⌃R |
Sortierung umschalten: nach Relevanz oder nach Zeit |
⇥ |
mehrere Zeilen markieren |
'wort |
exakter Treffer statt unscharf |
^git / log$ |
Anfang / Ende der Zeile |
!kubectl |
Zeilen mit kubectl ausschließen |
⌃C / Esc |
abbrechen |
Achtung: fzf belegt
⌥Cund⌃Tneu. Das war in Tag 3 „Wort groß schreiben” bzw. „Zeichen tauschen”. Wer das braucht, bindet es auf eine andere Taste. ⌃T und ⌥C vertiefst du an Tag 7.
Fortschritt speichern? Kostenlos registrieren
Drill 6: atuin – History als Datenbank
atuin speichert jeden Befehl in SQLite, zusammen mit Verzeichnis, Exit-Code, Dauer, Host und Session. Sync zwischen Rechnern ist optional und Ende-zu-Ende-verschlüsselt. Wir lassen ihn aus.
Achtung: Jeder
atuin-Aufruf ohneATUIN_CONFIG_DIRlegt~/.config/atuinund~/.local/share/atuinan, auch ein harmlosesatuin default-config. Ruf atuin in diesem Buch nur in der Lab-Shell auf.
Erst die Lab-Konfiguration, dann die Shell-Anbindung:
mkdir -p ~/term-lab/config/atuin
cat > ~/term-lab/config/atuin/config.toml <<EOF
# Lab-Konfiguration für atuin – alles bleibt unter ~/term-lab
data_dir = "$HOME/term-lab/data/atuin"
auto_sync = false
update_check = false
enter_accept = false
filter_mode = "global"
style = "compact"
inline_height = 20
history_filter = ["^ ", "sk-lab-"]
EOF
cat > ~/term-lab/config/zsh/atuin.zsh <<'EOF'
# ~/term-lab/config/zsh/atuin.zsh – atuin auf ⌥R (Tag 4), ⌃R bleibt bei fzf
export ATUIN_CONFIG_DIR=$LAB/config/atuin
eval "$(atuin init zsh --disable-ctrl-r --disable-up-arrow)"
bindkey -M emacs '^[r' atuin-search
EOF
exec ~/term-lab/lab
atuin info | grep 'db path'Erwartet:
client db path: /Users/du/term-lab/data/atuin/history.db
meta db path: /Users/du/term-lab/data/atuin/meta.db
Warum ⌥R und nicht ⌃R? So hast du beide Werkzeuge nebeneinander und
entscheidest später. --disable-up-arrow lässt ↑ bei der
Präfix-Suche aus Drill 3. enter_accept = false sorgt dafür,
dass ⏎ den Befehl nur in den Prompt legt, statt ihn sofort
auszuführen. history_filter sind reguläre Ausdrücke für
Befehle, die atuin nie speichert.
Die bisherige Lab-History übernehmen:
HISTFILE=$HISTFILE atuin import zshErwartet (gekürzt):
Importing history from zsh
Import complete!
Das HISTFILE=$HISTFILE davor ist wichtig: zsh exportiert
die Variable nicht. Ohne sie liest atuin ~/.zsh_history,
also deine echte History.
Jetzt ⌥R. atuin öffnet eine Liste mit Dauer und Zeit,
etwa so (Darstellung kann je nach Version abweichen):
5ms 0s ago grep -c ERROR logs/app.log
4ms 1m ago wc -l logs/app.log
...
[ GLOBAL ] >
Im Fenster wechselt ⌃R den Filter: GLOBAL, HOST,
SESSION, DIRECTORY. ⇥ übernimmt die Zeile zum Bearbeiten,
Esc bricht ab.
Fortschritt speichern? Kostenlos registrieren
Drill 7: Suchen nach Verzeichnis und Exit-Code
Erzeuge ein paar Einträge mit Erfolg und Misserfolg in zwei Verzeichnissen:
cd ~/term-lab/projekt
grep -c ERROR logs/app.log
cat gibtsnicht.txt
cd internal/cart
head -5 cart.go
ls
export LAB_TOKEN=lab-wert-ohne-bedeutung
echo sk-lab-master-1234
cd ~/term-lab/projektWas ist schiefgegangen?
atuin search --exclude-exit 0 --cwd . --format "{exit} {command}"Erwartet:
1 cat gibtsnicht.txt
Was habe ich in internal/cart gemacht?
--cwd braucht einen absoluten Pfad:
atuin search --cwd $PWD/internal/cart --format "{duration} {command}"Erwartet (deine Zeiten weichen ab):
7ms head -5 cart.go
2ms ls
Und die Secrets?
atuin search LAB_TOKEN | wc -l
atuin search sk-lab | wc -lErwartet:
0
0
Der erste fehlt wegen des Leerzeichens, der zweite wegen
history_filter. Importierte Einträge aus der zsh-History
haben übrigens Exit-Code -1 und kein Verzeichnis. Diese
Daten kennt nur atuin selbst.
| Frage | Befehl |
|---|---|
| Was lief hier im Ordner? | atuin search --cwd . |
| Was ist fehlgeschlagen? | atuin search --exclude-exit 0 |
| Was lief nur erfolgreich? | atuin search --exit 0 kubectl |
| Was lief seit gestern? | atuin search --after yesterday |
| Was war langsam? | atuin search --format "{duration} {command}" |
| Wie oft tippe ich was? | atuin stats |
Fortschritt speichern? Kostenlos registrieren
Shortcut-Tabelle
| Taste | Wirkung | Merkhilfe |
|---|---|---|
↑ / ↓ |
History, mit Präfix gefiltert | hoch = früher |
⌃R |
Suche in der History (fzf) | Reverse search |
⌃R in fzf |
Sortierung Relevanz / Zeit | Reihenfolge |
⌥R |
atuin-Suche | R mit Extra |
⌃R in atuin |
Filter: global, Host, Session, Ordner | Reichweite |
⌃G |
Suche abbrechen (eingebaut) | Go away |
⌥. |
letztes Wort des vorigen Befehls | Punkt = das Letzte |
␣befehl |
nicht in die History | Leerzeichen = leise |
r |
letzten Befehl wiederholen | repeat |
fc |
letzten Befehl im Editor | fix command |
Kontrollpunkt
LAB=${LAB:-~/term-lab}
ok() { local m=$1; shift; "$@" >/dev/null 2>&1 && echo "✔ $m" || echo "✘ $m"; }
lab() { env ZDOTDIR="$LAB/zsh" zsh -i -c "$1" 2>/dev/null; }
ok "100000 Einträge" test "$(lab 'echo $SAVEHIST')" -ge 100000
ok "Leerzeichen-Schutz" lab '[[ -o histignorespace ]]'
ok "geteilte History" lab '[[ -o sharehistory ]]'
ok "↑ mit Präfix" lab '[[ $(bindkey "^[[A") == *beginning-search ]]'
ok "⌃R = fzf" lab '[[ $(bindkey "^R") == *fzf-history-widget ]]'
ok "⌥R = atuin" lab '[[ $(bindkey "^[r") == *atuin-search ]]'
ok "atuin-DB im Lab" lab 'atuin info | grep -q "db path: $LAB/data/atuin"'
ok "kein Lab-Token in DB" test "$(lab 'atuin search sk-lab | wc -l')" -eq 0Erwartet:
✔ 100000 Einträge
✔ Leerzeichen-Schutz
✔ geteilte History
✔ ↑ mit Präfix
✔ ⌃R = fzf
✔ ⌥R = atuin
✔ atuin-DB im Lab
✔ kein Lab-Token in DB
Und der Praxistest: Öffne mit ⌘D einen zweiten Split mit
der Lab-Shell. Tippe links echo aus-dem-linken-split,
rechts ↑. Dank SHARE_HISTORY erscheint der
Befehl sofort.
Challenge
Zeig alle fehlgeschlagenen Befehle der letzten sieben Tage, die du im Projektordner ausgeführt hast. Neueste zuerst, mit Uhrzeit und Exit-Code.
Hinweis: atuin search --help kennt
Filter für Exit-Code, Verzeichnis und Zeit sowie
--reverse.
Lösung
cd ~/term-lab/projekt
atuin search --exclude-exit 0 --cwd $PWD --after "7 days ago" --reverse \
--format "{time} {exit} {command}"Erwartet (deine Zeiten weichen ab):
2026-10-10 08:57:23 1 cat gibtsnicht.txt
--after versteht natürliche Angaben wie
yesterday oder "2 hours ago". Wer das öfter
braucht, macht daraus an Tag 5 eine Funktion fails.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Die History ist ein Sicherheitsrisiko: Tokens in
curl -H "Authorization: …", Passwörter inmysql -p…. Gewöhn dir das führende Leerzeichen an und pflegehistory_filterin atuin. Prüfe ab und zu mitrg -i 'token|passw|secret' $HISTFILE. - atuin-Sync über
api.atuin.shist verschlüsselt, verlässt aber trotzdem das Firmennetz. Vor dem Einschalten Datenschutz und Security fragen. Alternative: eigener atuin-Server im Firmennetz oder kein Sync. - Auf Jump-Hosts und in Containern gibt es weder fzf noch atuin. ⌃R,
!$,fcundhistory | grepfunktionieren dort trotzdem. SHARE_HISTORYist praktisch, mischt aber Befehle aus parallelen Sessions. Wer in einem Pane gegen prod arbeitet, sollte die History-Suche dort besonders bewusst nutzen (Tag 14).- Gemeinsame Admin-Accounts mit gemeinsamer History sind ein Audit-Albtraum. Persönliche Accounts plus zentrales Logging (z. B. auditd oder Session-Recording am Bastion-Host) sind der Standard.