Terminal & Sessions

Was es ist

Eine Session ist eine tmux-Session (Prefix cc-), die eine Coding-CLI (Claude Code, Codex, Antigravity oder opencode) in einem Projektverzeichnis ausführt. tmux ist die einzige Quelle der Wahrheit: Der Hub hält keinen eigenen Session-State, weshalb Sessions einen Hub-Neustart überleben und sogar von außerhalb von Penates gestartete Sessions adoptiert werden können (z. B. über SSH oder Moshi).

Warum / wann

Das Dashboard ist der einzige Ort, um alle laufenden Agents im Blick zu haben und zu steuern: Live-Aktivität (working · waiting · idle), Context-Token-Verbrauch und das Account-5h-Limit pro Karte, dazu ein CLI-Badge zur Identifikation. Jede Session wird über ein vollwertiges Browser-Terminal bedient (Farben, Copy/Paste, Scrollback) vom Mac oder vom Smartphone.

Wie nutzen

• Erstellen: New session klicken, CLI und Approval-/Sandbox-Variante wählen, Verzeichnis auswählen, starten. Namen bekommen automatisch den Prefix cc-.
• Verbinden: Karte öffnen, um über einen robusten WebSocket ins Terminal zu wechseln (automatischer Reconnect mit Backoff; Scrollback-Replay beim ersten Verbinden).
• Multi-CLI: Der Picker bietet Claude Code, Codex (--sandbox-Varianten), Antigravity (agy) und opencode, jede CLI mit eigenem Login.
• Umbenennen / adoptieren / anpinnen / stummschalten: Umbenennen behält den Hook-State; adoptieren registriert eine fremde Session unter ihrem Originalnamen; anpinnen sortiert sie nach oben; stummschalten unterdrückt ihre Benachrichtigungen.
• Auto-Restore: Nach einem Neustart startet der Hub die zuletzt laufenden cc--Sessions in ihrem ursprünglichen Verzeichnis neu und setzt die CLI-Konversation fort (claude --continue, codex resume --last, agy --continue). Opt-out durch bewusstes Stoppen der Session.
• Copy/Paste in der iOS-PWA: Die installierte iPhone-App bekommt zwei Touch-Bar-Tasten, da es kein Hardware-Cmd+C/V gibt. Paste liest die Zwischenablage beim Tap und sendet sie per Bracketed-Paste. Copy startet mit Long-Press-und-Drag (als Mouse-Events an tmux weitergereicht, ein normaler Swipe scrollt weiterhin); beim Loslassen wird die Selektion aus dem tmux-Paste-Buffer gelesen und beim nächsten Copy-Tap kopiert. Copy braucht tmux als Empfänger des Drags, funktioniert also am Shell-Prompt; Vollbild-CLIs, die die Maus selbst abfangen (Claude Code, Codex), sind von Copy nicht betroffen.

Grenzen

Auto-Restore gilt nur nach einem Neustart und stellt die CLI-Konversation wieder her, keinen unterbrochenen Task und keinen im RAM gespeicherten tmux-Scrollback. Fremde (nicht über den Hub gestartete) Sessions zeigen Aktivität unknown, bis ein Hook feuert. Die @-Mention-Helfer (Image-Paste, Voice) sind Claude-Code-spezifisch.