Zum Inhalt springen
Trainingslager IT-Trainingslager

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 $SAVEHIST

Erwartet (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 hist

Erwartet:

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 $HISTFILE

Erwartet (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_SPACE ist 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 per read -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*' 1

Erwartet (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; done

Erwartet:

"^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 ⌥C und ⌃T neu. 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 ohne ATUIN_CONFIG_DIR legt ~/.config/atuin und ~/.local/share/atuin an, auch ein harmloses atuin 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 zsh

Erwartet (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/projekt

Was 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 -l

Erwartet:

       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 0

Erwartet:

✔ 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 in mysql -p…. Gewöhn dir das führende Leerzeichen an und pflege history_filter in atuin. Prüfe ab und zu mit rg -i 'token|passw|secret' $HISTFILE.
  • atuin-Sync über api.atuin.sh ist 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, !$, fc und history | grep funktionieren dort trotzdem.
  • SHARE_HISTORY ist 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.