Sessions und Workflow

Tactic Remote verwendet tmux-Sessions, um deine Claude Code-Prozesse über Verbindungsabbrüche hinweg am Leben zu halten. Diese Seite erklärt, wie Sessions funktionieren und den täglichen Workflow.

Wie Sessions funktionieren

Jede Session entspricht:

• Einem Arbeitsverzeichnis (dein Projektordner).
• Einer tmux-Session auf deinem Mac, die Claude Code ausführt.
• Einem Terminal-Ausgabestrom, der auf deinem iPhone angezeigt wird.

Sessions bleiben bestehen, auch wenn:

• Die iPhone-App geschlossen oder in den Hintergrund versetzt wird.
• Die Netzwerkverbindung vorübergehend abbricht.
• Der Mac in den Ruhezustand geht und aufwacht.

Beim Reconnect stellt die App die Session und ihre Terminal-Ausgabe wieder her.

Session erstellen

1. Tippe auf die Session-Auswahl (oben links in der App).
2. Tippe auf Neue Session.
3. Durchsuche das Dateisystem deines Macs und wähle ein Projektverzeichnis.
4. Benenne die Session (z. B. meine-api, frontend-arbeit).
5. Tippe auf Erstellen.

Du kannst mehrere Sessions für verschiedene Projekte haben und zwischen ihnen wechseln.

Claude Code starten

Tippe auf den Start-Button, um Claude Code in der aktuellen Session zu starten.

Die App hat einen Doppelstart-Schutz: Wenn Claude Code bereits in der Session läuft, bewirkt Start-Tippen nichts. Das verhindert versehentliche doppelte Starts.

Vor dem Starten prüfen: Schau auf die Statusanzeige. Grün „Läuft" bedeutet, Claude ist bereits aktiv -- kein Start nötig.

Prompts senden

Tippe in die Chat-Eingabe und sende. Dein Prompt geht über den WebSocket an deinen Mac, der ihn an den Claude Code-Prozess weitergibt. Die Ausgabe wird in Echtzeit zurückgestreamt.

Schnellaktionen

Die App bietet Schnellschaltflächen für häufige Terminal-Eingaben:

• Enter -- Eingabe bestätigen
• Escape -- aktuelle Operation abbrechen
• Tab -- Autovervollständigung
• Pfeiltasten -- navigieren
• Ctrl+C -- unterbrechen

Reconnect

Wenn die App die Verbindung verliert (Netzwerkwechsel, Hintergrund-Modus, etc.):

1. Sie versucht automatisch, sich mit exponentiellem Backoff wieder zu verbinden.
2. Bei Reconnect verbindet sie sich erneut mit deiner bestehenden tmux-Session.
3. Terminal-Ausgabe, die während der Trennung angefallen ist, wird wiederhergestellt.

Du musst nichts tun -- öffne einfach die App erneut.

Falls die Ansicht veraltet wirkt: Öffne die Session-Auswahl und wähle deine Session erneut aus. Das erzwingt eine Aktualisierung.

Benachrichtigungen

Für lang laufende Aufgaben musst du die App nicht offen halten:

1. Claude Code unterstützt Hooks, die bei Aufgabenabschluss ausgelöst werden.
2. Der Server leitet diese Events als Push-Benachrichtigungen an dein iPhone weiter.
3. Wenn die Benachrichtigung ankommt, öffne die App, um das Ergebnis zu prüfen.

Halte die iOS-Benachrichtigungsberechtigungen für Tactic Remote aktiviert.

Session beenden

• Claude stoppen: Tippe auf den Stop-Button, um den Claude Code-Prozess zu beenden. Die Session bleibt für einen späteren Neustart verfügbar.
• Session löschen: In der Session-Auswahl wischen, um zu löschen. Das entfernt die tmux-Session von deinem Mac.