Zum Inhalt springen
Trainingslager IT-Trainingslager

Tag 8: tmux I – Sessions, Windows, Panes

Ziel: In tmux mit Sessions, Fenstern und Panes nur per Tastatur arbeiten, Text im Copy-Mode kopieren und eine eigene Konfiguration mit Prefix ⌃a bauen. · Dauer: ca. 75 min · Voraussetzung: Tag 7

Briefing

  • tmux ist ein Server, der Shells am Leben hält. Dein Terminal ist nur ein Client. Fenster zu, SSH weg: die Session läuft weiter.
  • Hierarchie: Server → Session (ein Projekt) → Window (ein Tab) → Pane (ein Split).
  • Jede tmux-Taste beginnt mit dem Prefix. Standard ist ⌃b, wir nehmen ⌃a (liegt besser, ist bei Senior Engineers verbreitet).
  • Das Lab nutzt einen eigenen Socket (-L lab) und eine eigene Datei (-f ~/term-lab/tmux.conf). Dein normales tmux bleibt unberührt.
tmux-Server  (Socket: /tmp/tmux-<uid>/lab)
 ├─ Session "lab"
 │   ├─ Window 1: zsh    ┌──────────┬──────────┐
 │   │                   │ Pane 1   │ Pane 2   │
 │   │                   │          ├──────────┤
 │   │                   │          │ Pane 3   │
 │   │                   └──────────┴──────────┘
 │   └─ Window 2: logs
 └─ Session "ops"

Drill 1: Lab-tmux starten, verlassen, zurückkehren

Erst die Konfiguration, dann eine Funktion tl, die immer Socket und Datei mitgibt:

cat > ~/term-lab/tmux.conf <<'EOF'
# ~/term-lab/tmux.conf – Lab-Konfiguration (Tag 8, ergänzt in Tag 9)

# --- Prefix: Ctrl-a statt Ctrl-b ------------------------------------------
unbind C-b
set -g prefix C-a
bind C-a send-prefix              # ⌃a ⌃a schickt ⌃a an die Shell

# --- Grundlagen ------------------------------------------------------------
set -g default-terminal "tmux-256color"
set -as terminal-features ",xterm-256color:RGB,xterm-ghostty:RGB"
set -sg escape-time 10            # Esc sofort an nvim weitergeben
set -g history-limit 50000
set -g base-index 1               # Fenster ab 1 zählen (Taste 1 liegt links)
setw -g pane-base-index 1
set -g renumber-windows on
set -g focus-events on
set -g display-time 2000

# Konfig neu laden
bind r source-file "$LAB/tmux.conf" \; display "tmux.conf neu geladen"
EOF
cat > ~/term-lab/config/zsh/tmux.zsh <<'EOF'
# tmux.zsh – Lab-tmux (Tag 8): eigener Socket, eigene Konfig
tl() { tmux -L lab -f "$LAB/tmux.conf" "$@"; }
EOF
reload
cd ~/term-lab/projekt
tl new -s lab

Du bist jetzt in tmux. Unten steht die grüne Standard-Statuszeile mit [lab] 1:zsh*. Die Shell darin ist deine Lab-zsh, weil der tmux-Server ZDOTDIR und LAB von der startenden Shell erbt.

Jetzt ⌃a d (detach). Du bist zurück in der normalen Shell:

tl ls

Erwartet (gekürzt):

[detached (from session lab)]
lab: 1 windows (created Sat Oct 10 08:51:12 2026)

Die Session lebt weiter. Zurück:

tl attach -t lab

Tipp: tl new -A -s lab ist „attach, sonst neu anlegen”. Das ist der eine Befehl, den du dir für jeden Tag merkst.

set -sg escape-time 10 ist wichtig für Neovim: Ohne die Zeile wartet tmux 500 ms, ob nach Esc noch eine Taste kommt. $LAB in source-file setzt tmux beim Laden ein.

Fortschritt speichern? Kostenlos registrieren

Drill 2: Sessions – ein Projekt, eine Session

Lege von innen eine zweite Session an und wechsle hin und her:

tmux new -d -s ops -c /tmp
tmux ls

Erwartet (gekürzt):

lab: 1 windows (created Sat Oct 10 08:51:12 2026) (attached)
ops: 1 windows (created Sat Oct 10 08:51:52 2026)

Innerhalb von tmux reicht tmux ohne -L: Die Variable $TMUX zeigt auf den richtigen Socket. Jetzt per Tastatur:

  • ⌃a s öffnet den Session-Baum. Mit j/k wählen, Enter springt hin, x beendet.
  • ⌃a ( und ⌃a ) wechseln zur vorherigen und nächsten Session.
  • ⌃a $ benennt die aktuelle Session um.
(0) + lab: 1 windows (attached)
(1) + ops: 1 windows
┌ lab (sort: index) (view: preview) ─────────────────────────────────┐
│ [lab] projekt %                                                    │

Aufräumen ohne Tastatur:

tmux kill-session -t ops
tmux ls

Erwartet:

lab: 1 windows (created Sat Oct 10 08:51:12 2026) (attached)

Fortschritt speichern? Kostenlos registrieren

Drill 3: Windows – Tabs im Terminal

Taste Wirkung
⌃a c neues Fenster (im aktuellen Pfad, siehe Drill 4)
⌃a , Fenster umbenennen
⌃a 1 … 9 zu Fenster Nummer n
⌃a n / ⌃a p nächstes / vorheriges Fenster
⌃a w Baum aller Fenster aller Sessions
⌃a & Fenster schließen (mit Rückfrage)

Übung: ⌃a c, dann ⌃a ,, Namen löschen mit ⌃U, logs tippen, Enter. Im neuen Fenster:

tail -f logs/app.log

Dann ⌃a c für ein drittes Fenster und ⌃a 1 zurück zum ersten. Prüfen:

tmux list-windows \
  -F '#{window_index}:#{window_name} panes=#{window_panes} #{?window_active,*,}'

Erwartet:

1:zsh panes=1 *
2:logs panes=1
3:zsh panes=1

Die Statuszeile zeigt dasselbe: [lab] 1:zsh* 2:logs 3:zsh-. * ist das aktive, - das zuletzt benutzte Fenster.

Fortschritt speichern? Kostenlos registrieren

Drill 4: Panes – Splits mit | und -

Die Standardtasten % und " kann sich niemand merken. | sieht aus wie ein senkrechter Schnitt, - wie ein waagrechter. Neue Panes öffnen im aktuellen Pfad:

cat >> ~/term-lab/tmux.conf <<'EOF'

# --- Fenster und Panes ------------------------------------------------------
unbind '"'
unbind %
bind | split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"
bind c new-window -c "#{pane_current_path}"

# vim-artig zwischen Panes wechseln, mit Shift die Größe ändern (wiederholbar)
bind h select-pane -L
bind j select-pane -D
bind k select-pane -U
bind l select-pane -R
bind -r H resize-pane -L 5
bind -r J resize-pane -D 5
bind -r K resize-pane -U 5
bind -r L resize-pane -R 5
bind -r C-h previous-window
bind -r C-l next-window
bind Tab last-window
EOF
tmux source-file ~/term-lab/tmux.conf
tmux list-keys -T prefix | rg 'split-window|select-pane -L'

Erwartet:

bind-key    -T prefix -       split-window -v -c "#{pane_current_path}"
bind-key    -T prefix h       select-pane -L
bind-key    -T prefix |       split-window -h -c "#{pane_current_path}"

Jetzt die Fingerübung, alles im ersten Fenster:

  1. ⌃a | teilt senkrecht, ⌃a - teilt das rechte Pane waagrecht.
  2. ⌃a h springt nach links, ⌃a l nach rechts, ⌃a j/⌃a k runter und hoch.
  3. ⌃a H und dann mehrmals H (ohne Prefix, -r = repeat) macht das Pane breiter.
  4. ⌃a z zoomt das aktive Pane auf volle Größe und zurück.
  5. ⌃a q zeigt Pane-Nummern, die Ziffer springt hin.
  6. ⌃a x schließt das Pane (mit Rückfrage), ⌃a ! macht daraus ein eigenes Fenster.
tmux list-panes -F '#{pane_index} #{pane_width}x#{pane_height} active=#{pane_active}'

Erwartet (nach Schritt 1 und 2, Größen abhängig vom Terminal):

1 60x39 active=1
2 59x19 active=0
3 59x19 active=0

Achtung: bind -r erlaubt Wiederholung ohne Prefix für 500 ms (repeat-time). Deshalb liegt Navigation mit h/j/k/l bewusst ohne -r: Sonst landet ein schnell getipptes l im falschen Pane statt in der Shell.

Fortschritt speichern? Kostenlos registrieren

Drill 5: tmux per Befehl steuern

Alles, was eine Taste kann, kann auch der Befehl tmux. Das ist die Basis für Projekt-Skripte in Tag 9. Öffne ein frisches Fenster (⌃a c) und tippe:

tmux split-window -h -c ~/term-lab/projekt
tmux send-keys -t '{right}' 'git log --oneline -3' Enter
tmux select-pane -t '{left}'
sleep 1; tmux capture-pane -p -t '{right}' | head -4

Erwartet:

[lab] projekt % git log --oneline -3
2e4e6aa (HEAD -> main) chore: Config, Manifeste, Report
a57983c feat: Warenkorb und HTTP-Server
1dc0abc init: Projektgerüst
  • send-keys tippt in ein Pane, als säßest du davor. Enter ist der Tastenname.
  • capture-pane -p liest den Bildschirminhalt eines Panes. Ideal für Tests und Skripte.
  • {left}, {right}, {last} sind Ziele relativ zum aktiven Pane. Sonst gilt session:fenster.pane, z. B. lab:2.1.
tmux display -p '#{session_name}:#{window_index}.#{pane_index} #{pane_current_path}'

Erwartet:

lab:4.1 /Users/du/term-lab/projekt

Formate wie #{pane_current_path} liefern dir jede Information aus tmux. Die Liste steht in man tmux unter FORMATS.

Fortschritt speichern? Kostenlos registrieren

Drill 6: Copy-Mode mit vi-Tasten und pbcopy

Scrollen, suchen und kopieren geht in tmux ohne Maus. Der Copy-Mode spricht vim (Tag 11):

cat >> ~/term-lab/tmux.conf <<'EOF'

# --- Copy-Mode mit vi-Tasten -------------------------------------------------
setw -g mode-keys vi
set -g set-clipboard on           # OSC 52: Kopieren klappt auch über SSH
bind Enter copy-mode
bind -T copy-mode-vi v send -X begin-selection
bind -T copy-mode-vi C-v send -X rectangle-toggle
bind -T copy-mode-vi y send -X copy-pipe-and-cancel "pbcopy"
bind -T copy-mode-vi Escape send -X cancel
bind P paste-buffer
EOF
tmux source-file ~/term-lab/tmux.conf
clear; grep -m3 ERROR logs/app.log

Erwartet:

2026-10-05T08:06:42 checkout ERROR request_id=r0006 user=u06
2026-10-05T08:16:52 checkout ERROR request_id=r0016 user=u16
2026-10-05T08:26:02 checkout ERROR request_id=r0026 user=u03

Jetzt die Tastenfolge:

  1. ⌃a Enter startet den Copy-Mode (oben rechts erscheint [0/…]).
  2. ?request_id und Enter sucht rückwärts, n springt zum nächsten Treffer.
  3. v beginnt die Auswahl, E erweitert bis zum Ende des WORTs.
  4. y kopiert nach tmux und über pbcopy in die macOS-Zwischenablage.
pbpaste; echo
tmux show-buffer; echo

Erwartet:

request_id=r0026
request_id=r0026

⌃a P (groß) fügt den tmux-Puffer ein – das kleine ⌃a p bleibt „vorheriges Fenster”, ⌘V die macOS-Zwischenablage. Beides hat jetzt denselben Inhalt.

Weitere Bewegungen im Copy-Mode: ⌃u/⌃d halbe Seite, g/G Anfang/Ende der History, w/b Wörter, 0/$ Zeilenanfang/-ende, V ganze Zeile, ⌃v Block. q oder Esc beendet.

Tipp: set-clipboard on schickt den kopierten Text zusätzlich per OSC 52 an die Terminal-App (Tag 1). Das ist der Weg, wenn tmux auf einem Server läuft und pbcopy dort nicht existiert.

Fortschritt speichern? Kostenlos registrieren

Drill 7: Maus, Statuszeile, Neuladen

Die Maus bleibt aus. Klicken lenkt ab, und mit Maus markierter Text landet im tmux-Puffer statt im Terminal. Für Präsentationen oder Pair-Sessions schaltest du sie per Taste ein. Dazu eine ruhige Statuszeile, die anzeigt, ob der Prefix gedrückt ist:

cat >> ~/term-lab/tmux.conf <<'EOF'

# Maus aus: Tastatur zuerst. Bei Bedarf mit Prefix m umschalten.
set -g mouse off
bind m set -g mouse \; display "Maus: #{?mouse,an,aus}"

# --- Statuszeile --------------------------------------------------------------
set -g status-position bottom
set -g status-style "bg=colour236,fg=colour250"
set -g status-left "#[fg=colour16,bg=colour214,bold] #S #[default] "
set -g status-left-length 30
set -g status-right \
  "#{?client_prefix,#[fg=colour16 bg=colour214] PREFIX #[default] ,}%H:%M "
setw -g window-status-current-style "fg=colour214,bold"
setw -g window-status-format " #I:#W "
setw -g window-status-current-format " #I:#W#{?window_zoomed_flag, [Z],} "
EOF

Jetzt ⌃a r (neu laden). Für zwei Sekunden steht tmux.conf neu geladen in der Statuszeile, danach der Session-Name orange hinterlegt links:

 lab   1:zsh   2:logs   3:zsh   4:zsh                                        08:52

Drücke ⌃a und warte: rechts erscheint PREFIX. ⌃a m meldet Maus: an, noch einmal Maus: aus. Ein gezoomtes Pane (⌃a z) bekommt [Z] am Fensternamen.

tmux show -g mouse; tmux show -g prefix; tmux show -g mode-keys

Erwartet:

mouse off
prefix C-a
mode-keys vi

Die komplette Datei liegt unter $BUCH/tmux/tmux.conf, dort schon mit den Erweiterungen aus Tag 9.

Fortschritt speichern? Kostenlos registrieren

Shortcut-Tabelle

Taste Wirkung Merkhilfe
⌃a d Session verlassen (läuft weiter) detach
⌃a s / ⌃a w Sessions / Fenster als Baum sessions, windows
⌃a ( / ⌃a ) vorherige / nächste Session Klammer = Session
⌃a $ / ⌃a , Session / Fenster umbenennen $ wie Variable, Komma wie Name
⌃a c neues Fenster create
⌃a 1–9, ⌃a Tab Fenster n, letztes Fenster Tab wie Alt-Tab
⌃a | / ⌃a - Split senkrecht / waagrecht sieht aus wie der Schnitt
⌃a h j k l Pane wechseln vim-Richtungen
⌃a H J K L Pane vergrößern (wiederholbar) groß = größer
⌃a z Pane zoomen zoom
⌃a x / ⌃a ! Pane schließen / zu Fenster machen x = weg, ! = raus
⌃a q Pane-Nummern zeigen quick numbers
⌃a Enter Copy-Mode, dann v … y Enter = rein
⌃a P tmux-Puffer einfügen Paste
⌃a r / ⌃a m Konfig laden / Maus umschalten reload, mouse
⌃a ⌃a ⌃a an die Shell (Zeilenanfang) doppelt = durchreichen
⌃a ? alle Tastenbelegungen Hilfe

Kontrollpunkt

Läuft in tmux oder außerhalb, solange die Lab-Session existiert:

c() { eval "$2" >/dev/null 2>&1 && echo "✔ $1" || echo "✘ $1"; }
c "Lab-Session läuft"    'tl has-session -t lab'
c "Prefix ⌃a"            '[[ $(tl show -gv prefix) == C-a ]]'
c "Split mit |"          'tl list-keys -T prefix "|" | rg -q split-window'
c "Pane-Wechsel mit h"   'tl list-keys -T prefix h | rg -q "select-pane -L"'
c "Fenster ab 1"         '[[ $(tl show -gv base-index) == 1 ]]'
c "Copy-Mode vi"         '[[ $(tl show -gv mode-keys) == vi ]]'
c "y kopiert per pbcopy" 'tl list-keys -T copy-mode-vi y | rg -q pbcopy'
c "Maus aus"             '[[ $(tl show -gv mouse) == off ]]'
c "Lab-zsh in tmux"      '[[ $(tl show-environment -g ZDOTDIR) == *term-lab/zsh ]]'

Erwartet: neun Zeilen mit ✔.

Challenge

Leg ⌃a g so an, dass ein neues Fenster namens git im Pfad des aktuellen Panes lazygit startet. Beendest du lazygit mit q, verschwindet das Fenster von selbst.

Hinweis: new-window nimmt einen Befehl als letztes Argument. Ein Fenster lebt nur so lange wie sein Befehl.

Lösung

cat >> ~/term-lab/tmux.conf <<'EOF'

# Challenge Tag 8: lazygit in eigenem Fenster
bind g new-window -n git -c "#{pane_current_path}" lazygit
EOF
tmux source-file ~/term-lab/tmux.conf

Drücke ⌃a g im Projekt, dann in einem anderen Pane:

tmux list-windows -F '#{window_index}:#{window_name} #{pane_current_command}'

Erwartet (gekürzt):

1:zsh zsh
2:logs tail
5:git lazygit

Nach q in lazygit ist Fenster 5 weg. In Tag 9 öffnest du lazygit stattdessen als Popup.

Fortschritt speichern? Kostenlos registrieren

Enterprise-Notiz

  • Auf Servern gilt oft der Standard-Prefix ⌃b. Läuft dort tmux in deinem lokalen tmux, schickst du mit ⌃a an dein lokales und mit ⌃b an das entfernte tmux (Tag 9).
  • tmux hält den Scrollback im Speicher (history-limit). Wer Secrets ausgibt, hat sie dort. tmux clear-history nach solchen Befehlen.
  • Der Socket liegt unter /tmp/tmux-<uid>/ mit Rechten nur für dich. Auf geteilten Jump-Hosts nie Sockets für andere freigeben (chmod, -S), außer für bewusstes Pairing.
  • Eine lange laufende Migration gehört in tmux, nicht in ein nacktes SSH-Fenster. Bricht die Verbindung ab, läuft sie weiter.
  • Die tmux.conf gehört in deine Dotfiles (Tag 13). Halte sie ohne Plugins lauffähig, damit sie auch auf frischen Servern funktioniert.