tmux

Tmux (Terminal-Multiplexer) ermöglicht es, Terminal-Sitzungen unabhängig von dem Fenster oder der SSH-Verbindung weiterlaufen zu lassen, die sie gestartet hat. Für Spck-CLI-Nutzer bedeutet das: Sitzungen bleiben nach einer Verbindungsunterbrechung erhalten, eine laufende Agent-Sitzung lässt sich zwischen Desktop und Mobilgerät teilen, und die CLI läuft dauerhaft auf einem Remote-Server weiter — auch wenn die SSH-Verbindung getrennt wird.

Installation

brew install tmux

sudo apt-get install tmux

sudo dnf install tmux

sudo pacman -S tmux

wsl --install

sudo apt-get install tmux

Anwendungsfall 1: Agent-Sitzungen zwischen Desktop und Mobilgerät teilen

Der wirkungsvollste tmux-Workflow mit Spck CLI besteht darin, einen KI-Coding-Agenten auf dem Desktop zu starten und ihn nahtlos vom Mobilgerät aus weiterzuführen — oder umgekehrt. Beide Clients sehen exakt den gleichen Terminal-Zustand einschließlich des vollständigen Scrollback-Verlaufs.

💡 Tipp: Wenn Sie einen ACP-kompatiblen Agenten (Claude Code, Codex, Gemini CLI) verwenden, können Sie ihn aus dem KI-Chat von Spck Editor steuern, ohne überhaupt ein Terminal zu teilen. Siehe KI-Coding-Agenten auf dem Handy (ACP) — tmux ist weiterhin nützlich für Shell-basierte Agenten oder wenn Sie die rohe Ausgabe des Agenten geräteübergreifend live verfolgen möchten.

Sitzung auf dem Desktop starten

Eine benannte tmux-Sitzung erstellen:

tmux new -s code

Den KI-Agenten innerhalb der Sitzung starten:

claude

Der Agent läuft innerhalb von tmux. Mit Strg+B und anschließend D kann die Sitzung jederzeit getrennt werden — die Sitzung und alles, was darin läuft, läuft im Hintergrund weiter.

Vom Mobilgerät verbinden

1. Spck Editor öffnen und mit dem CLI-Server verbinden
2. Ein Terminal aus dem Spck Editor-Terminal-Panel öffnen
3. Die laufende tmux-Sitzung verbinden:

tmux attach -t code

Das Terminal sieht genauso aus wie auf dem Desktop — einschließlich des laufenden Agenten, seiner Ausgabe und des vollständigen Scrollback-Verlaufs. Mehrere Clients können gleichzeitig verbunden sein und die Live-Ausgabe sehen.

Zurück zum Desktop wechseln

Jederzeit von einem beliebigen Terminal aus neu verbinden:

tmux attach -t code

Anwendungsfall 2: Dauerhaft laufende CLI auf einem Remote-Server

Wenn Spck CLI auf einem Remote-Server über SSH betrieben wird, stoppt die CLI sobald die SSH-Sitzung endet — egal ob der Laptop zugeklappt wird, die WLAN-Verbindung abbricht oder die Verbindung durch einen Timeout unterbrochen wird. Tmux hält den Prozess auf dem Server am Laufen, unabhängig vom Verbindungsstatus.

Einrichtung auf dem Remote-Server

Per SSH auf den Server verbinden und eine benannte tmux-Sitzung starten, bevor die CLI gestartet wird:

ssh [email protected]
tmux new -s spck
spck

Die CLI läuft jetzt innerhalb von tmux auf dem Server. Die SSH-Verbindung kann geschlossen werden — oder vollständig unterbrochen sein — und die CLI läuft weiter.

Nach einer Verbindungsunterbrechung neu verbinden

ssh [email protected]
tmux attach -t spck

Die CLI macht genau da weiter, wo sie aufgehört hat. Mobilclients können sich über den Relay-Server normal neu verbinden.

Laufende Sitzungen auflisten

tmux ls

Alternative: Linux-Dienst

Für ein vollständig automatisiertes Setup, das die CLI beim Systemstart ohne manuelle tmux-Verwaltung startet, kann Spck CLI als systemd-Dienst betrieben werden.

Dienstdatei erstellen

sudo nano /etc/systemd/system/spck-cli.service

[Unit]
Description=Spck CLI Server
After=network.target

[Service]
Type=simple
User=your-username
WorkingDirectory=/path/to/your/project
ExecStart=/usr/bin/npx spck
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

your-username und /path/to/your/project durch die tatsächlichen Werte ersetzen. Falls spck global installiert wurde (npm install -g spck), ExecStart durch die Ausgabe von which spck ersetzen.

Aktivieren und starten

sudo systemctl daemon-reload
sudo systemctl enable spck-cli
sudo systemctl start spck-cli

Status und Protokolle prüfen

# Status anzeigen
sudo systemctl status spck-cli

# Live-Protokoll verfolgen
journalctl -u spck-cli -f

Der Dienst startet automatisch bei jedem Neustart und startet sich selbst neu, wenn der Prozess abstürzt.

Wichtige Tmux-Befehle