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 labDu 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 lsErwartet (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 labTipp:
tl new -A -s labist „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 lsErwartet (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/kwählen,Enterspringt hin,xbeendet. - ⌃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 lsErwartet:
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.logDann ⌃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:
- ⌃a | teilt senkrecht, ⌃a - teilt das rechte Pane waagrecht.
- ⌃a h springt nach links, ⌃a l nach rechts, ⌃a j/⌃a k runter und hoch.
- ⌃a H und dann mehrmals H (ohne
Prefix,
-r= repeat) macht das Pane breiter. - ⌃a z zoomt das aktive Pane auf volle Größe und zurück.
- ⌃a q zeigt Pane-Nummern, die Ziffer springt hin.
- ⌃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 -rerlaubt Wiederholung ohne Prefix für 500 ms (repeat-time). Deshalb liegt Navigation mith/j/k/lbewusst ohne-r: Sonst landet ein schnell getippteslim 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 -4Erwartet:
[lab] projekt % git log --oneline -3
2e4e6aa (HEAD -> main) chore: Config, Manifeste, Report
a57983c feat: Warenkorb und HTTP-Server
1dc0abc init: Projektgerüst
send-keystippt in ein Pane, als säßest du davor.Enterist der Tastenname.capture-pane -pliest den Bildschirminhalt eines Panes. Ideal für Tests und Skripte.{left},{right},{last}sind Ziele relativ zum aktiven Pane. Sonst giltsession: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.logErwartet:
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:
- ⌃a Enter startet den Copy-Mode (oben rechts
erscheint
[0/…]). ?request_idund Enter sucht rückwärts,nspringt zum nächsten Treffer.vbeginnt die Auswahl,Eerweitert bis zum Ende des WORTs.ykopiert nach tmux und überpbcopyin die macOS-Zwischenablage.
pbpaste; echo
tmux show-buffer; echoErwartet:
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 onschickt 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 undpbcopydort 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],} "
EOFJetzt ⌃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-keysErwartet:
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.confDrü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-historynach 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.confgehört in deine Dotfiles (Tag 13). Halte sie ohne Plugins lauffähig, damit sie auch auf frischen Servern funktioniert.