Wendov1.0 · iOS & Android
Deutsch

Lernen

tmux für Coding-Agenten: das Minimum, damit sie weiterlaufen

· 4 Min. Lesezeit

Wenn du einen Agenten direkt aus einer SSH-Shell startest, lebt er so lange wie diese Verbindung. Mit tmux läuft der Agent auf dem Server, ob du verbunden bist oder nicht, und du hängst dich wieder an, wann du willst, von deinem Laptop oder vom Handy. Du musst tmux nicht tief kennen: etwa ein Dutzend Befehle genügt.

Das ist das Begleitstück zu Mosh oder SSH auf dem Handy, und es passt in die Anleitung Claude Code vom Handy aus nutzen.

Eine Session, die überlebt

Der Befehl, den du am häufigsten nutzt:

tmux new-session -A -s agents

Das Flag -A bedeutet: Existiert eine Session mit diesem Namen, hängst du dich an sie an, sonst wird sie angelegt. Du kannst also immer dasselbe ausführen. Starte darin deinen Agenten wie in jeder Shell:

cd ~/code/my-app
claude

Um zu gehen, ohne etwas zu beenden, trenne dich mit Ctrl-b und dann d. Der Agent läuft weiter. Um wieder hineinzukommen:

tmux attach -t agents

Und um zu sehen, welche Sessions existieren:

tmux ls

Wenn du das Terminal schließt, das WLAN abbricht oder SSH stirbt, ist das egal: Die Session bleibt auf dem Server. Das ist der ganze Sinn.

Fenster: ein Agent pro Fenster

Eine Session hat Fenster, wie Tabs. Die typische Situation: Ein langes Refactoring läuft in Fenster 2, während die Tests in Fenster 3 laufen und du in Fenster 1 etwas ausprobierst.

In tmux beginnt jedes Kürzel mit Ctrl-b:

  • c legt ein neues Fenster an.
  • , benennt das aktuelle Fenster um.
  • n und p wechseln zum nächsten und zum vorherigen Fenster.
  • 0–9 springen per Nummer zu einem Fenster.
  • w öffnet eine Liste zur Auswahl.

Du kannst Fenster auch von außen oder aus einem Skript anlegen und benennen:

tmux new-window -n claude -c ~/code/my-app
tmux new-window -n codex -c ~/code/my-app
tmux rename-window -t agents:2 refactor

Jedes Fenster zu benennen ist wichtiger, als es scheint. Auf dem Handy liest du „claude“, „codex“ oder „tests“ in einer kleinen Liste, und viermal hintereinander „bash“ hilft nicht.

Panes

Wenn du zwei Dinge gleichzeitig im selben Fenster sehen willst, teile es:

  • Ctrl-b % teilt das Fenster in zwei Spalten.
  • Ctrl-b " teilt es in zwei Zeilen.
  • Ctrl-b o springt zum nächsten Pane.
  • Ctrl-b x schließt das aktuelle Pane (es fragt vorher nach).

Auf einem Handy-Bildschirm ist ein Fenster pro Aufgabe meist besser als Panes. Auf einem Laptop nimm Panes.

Eine kleine ~/.tmux.conf

Zwei Einstellungen ändern das Erlebnis stark: Mausunterstützung und mehr Verlauf. Der Standardverlauf liegt bei etwa 2.000 Zeilen, und ein Agent verbraucht das schnell.

set -g mouse on
set -g history-limit 50000
set -g allow-rename off

Mit mouse on scrollst du mit dem Finger oder Mausrad und wählst Panes per Tipp. allow-rename off verhindert, dass das laufende Programm dein Fenster umbenennt. Lade sie neu mit:

tmux source-file ~/.tmux.conf

Um ohne Maus zu lesen, was weggescrollt ist, geh mit Ctrl-b [ in den Copy-Modus und bewege dich mit den Pfeiltasten oder PgUp nach oben; mit q verlässt du ihn. Das ist es, was Mosh dir nicht gibt und tmux schon.

Mehrere Agenten gleichzeitig: Git-Worktrees

Zwei Agenten, die im selben Verzeichnis editieren, treten sich auf die Füße. Die saubere Lösung ist ein Worktree pro Agent: Jeder arbeitet auf seinem eigenen Branch in seinem eigenen Ordner, mit demselben Repository.

cd ~/code/my-app
git worktree add ../my-app-auth -b feature/auth
git worktree add ../my-app-reports -b feature/reports
git worktree list

Dann für jeden ein tmux-Fenster:

tmux new-window -n auth -c ~/code/my-app-auth
tmux new-window -n reports -c ~/code/my-app-reports

Wenn ein Branch gemergt ist und du damit fertig bist:

git worktree remove ../my-app-auth

Wie Wendo es nutzt

Wendo ist ein SSH-Client für iOS und Android, gebaut, um Coding-Agenten zu verfolgen, und tmux ist sein zentrales Stück. Die tmux-Integration gehört zu Wendo Pro.

  • Beim Verbinden öffnen: Wähle tmux und optional einen Session-Namen. Wendo führt tmux new-session -A -s wendo aus (oder den Namen, den du gesetzt hast), sodass du bei jedem Öffnen der Verbindung wieder in deiner Session landest.
  • Maschinen zeigt die Sessions, Fenster und Panes jedes Rechners. Tippe auf eins, und es öffnet sich direkt dort.
  • Mit tmux kannst du im Workspaces-Sheet Fenster wechseln, umbenennen, Panes oder Fenster schließen und eine Session anlegen. Du kannst auch einen Agenten (Claude Code, Codex, OpenCode oder Gemini CLI) in einem neuen Fenster starten oder einen Git-Worktree auf einem neuen Branch anlegen und in einem eigenen Fenster öffnen, was du oben gerade von Hand gemacht hast.
  • Alerts im Posteingang führen dich zum genauen Pane, wenn Claude in einem Multiplexer läuft. Wie du den Hook installierst, steht in Alerts und Freigaben.

Die Terminal-Einstellungen enthalten das Anwenden globaler tmux-Optionen (Titel, Maus und Statusleiste). Alles steht in der tmux-Doku; und wenn deine Verbindung wackelig ist, erklärt die Doku zu Sessions Mosh und ET.

Alternativen: zellij und herdr

Wenn du einen anderen Multiplexer bevorzugst, funktioniert Wendo auch mit zellij (zellij attach -c wendo) und herdr (herdr oder herdr --session <name>). Sie müssen auf deinem Rechner installiert sein. Die Idee ist dieselbe: Der Agent lebt auf dem Server, und du kommst und gehst.