Zum Inhalt springen

Angehängte Terminals (SwiftTerm)

Die App kann ein echtes Terminal im Kontext eines Projekts starten und es in einem Fenster anhängen. Darunter liegen ganz normale tmux-Sessions, die die CLI verwaltet — sie laufen also weiter, wenn du die App beendest.

Eine angehängte Claude-Session im MultiDocker-Fenster: die Seitenleiste zeigt den Block „Aktiv“ mit den Sessions des Projekts und ihren Status-Labels, der Session-Header trägt den automatisch erzeugten Titel neben seiner Status-Kapsel.

Eine Session ist eine benannte tmux-Session, angelegt von engine/terminal.sh und in der Registry unter .projects[<name>].sessions[] vermerkt. Jede Session startet eines von mehreren Tools:

Tool Was es startet
claude Claude Code, im Projektverzeichnis
copilot GitHub Copilot CLI
shell eine einfache Shell im Projekt
exec eine docker compose exec-Shell in einen laufenden Service

Sessions heißen mdocker__<project>__<id> und sind damit in tmux leicht zu finden.

Fahre in der App mit der Maus über eine Projektzeile in der Seitenleiste und klicke auf das „+“, das das Profil-Badge ersetzt (Tooltip „Neue AI-Session erstellen“), oder nutze die AI-Sessions-Karte im Tab „Übersicht“ des Projekts. Im Sheet wählst du das Tool — Claude Code, GitHub Copilot oder Shell. exec-Sessions gibt es dort nicht: Die startest du über den Shell-Picker einer Service-Zeile im Tab „Services“ („Container-Shell öffnen (docker compose exec)“) oder auf der CLI. Der entsprechende CLI-Weg:

mdocker terminal
mdocker terminal new <name> --tool claude
mdocker terminal exec <name> shop # shell into the "shop" service
mdocker terminal list <name>
mdocker terminal kill <name> <session-id>

Die AI-Tools starten im ai_session_path des Projekts, falls einer gesetzt ist (sonst im Projekt-Wurzelverzeichnis).

Die App pollt mdocker terminal list --all — ein Aufruf pro Tick für alle Projekte — alle 2 s, solange die App aktiv ist, und alle 5 s, wenn sie es nicht ist, und nur so lange mindestens eine Session lebt. Aus den Feldern activity, alive und exited leitet sie drei Zustände ab:

Zustand Farbe Wann
„arbeitet“ rot die Session hat vor weniger als 3 s Ausgabe erzeugt
„wartet auf Eingabe“ orange sie lebt, ist aber untätig
„beendet“ grau die tmux-Session ist weg oder ihr Pane ist tot

Der Glow um eine Session folgt denselben drei Zuständen: ein durchgehend roter Glow, solange sie arbeitet, ein orangener Glow, der alle 1,1 s blinkt, solange sie auf dich wartet, und gar kein Glow mehr, sobald sie beendet ist.

Wechselt eine Session von arbeitet auf wartet auf Eingabe oder auf beendet, zeigt macOS eine Mitteilung mit dem Session-Namen als Titel und dem Text „wartet auf Eingabe (<projekt>)“ beziehungsweise „Session beendet (<projekt>)“. Ein Klick darauf wählt diese Session aus. Mitteilungen werden unterdrückt, solange die Session gerade vor dir geöffnet ist, und die App fragt die Mitteilungs-Berechtigung ab, sobald du zum ersten Mal eine Session anlegst.

Tools, die ihren Terminal-Titel über die Escape-Sequenzen OSC 0/2 setzen — Claude Code gehört dazu —, erscheinen in der App mit genau diesem Titel: tmux meldet ihn als pane_title, und eine angehängte Session übernimmt ihn live aus SwiftTerm. Generische tmux- oder Hostname-Defaults werden ignoriert, eine einfache Shell behält also ihren eigenen Namen. Der Session-Header zeigt den Titel plus eine Status-Kapsel und darunter <id> · tmux: <name>.

Die App bettet das Terminal mit SwiftTerm ein — einem nativen Terminal-Emulator. TerminalView umschließt SwiftTerms LocalProcessTerminalView und führt tmux attach -t =<name> mit aktivierter Maus-Unterstützung aus, du bekommst also ein voll interaktives Terminal direkt im App-Fenster.

Das Theme ist fest vorgegeben — es gibt keinen Picker: weiß auf schwarz, ein grüner Cursor und eine 16-Farben-Palette. Sessions werden mit abgeschalteter tmux-Statusleiste angelegt, das ganze Fenster gehört also dem Tool, das du gestartet hast.

Die Seitenleisten-Zeile „Alle AI-Sessions“ öffnet eine Ansicht über alle Projekte hinweg, gruppiert in die Sektionen „Arbeitet“, „Wartet auf Eingabe“ und „Beendet“ und sortiert nach Projektname und danach nach Session-ID. Ihr Zähler in der Seitenleiste zeigt, wie viele Sessions leben, mit einem rot pulsierenden Punkt, solange eine davon arbeitet.

Die Ansicht „Alle AI-Sessions“ in MultiDocker mit den Sektionen „Arbeitet“ und „Wartet auf Eingabe“, jede Zeile mit dem Projektnamen am rechten Rand.

Läuft nichts, steht dort „Keine AI-Sessions vorhanden.“ und ein Verweis zurück auf die Seitenleiste: „Sessions erstellst du in der Sidebar: Projekt-Zeile hovern und auf + klicken.“

Sessions mit AI-Tools können im Sandbox-Modus laufen, pro Session in der Registry vermerkt. Damit schränkst du ein, was ein AI-Agent in deinem Projekt anfassen kann. Das Sheet für neue Sessions in der App hat keinen Sandbox-Schalter — starte so eine Session über die CLI:

sandboxed session
mdocker terminal new <name> --tool claude --sandbox

Sessions stehen in der Registry, tote Einträge können sich also ansammeln, wenn ein tmux-Server neu startet. mdocker terminal prune <name> entfernt Registry-Einträge, deren tmux-Session es nicht mehr gibt, und hält die Liste damit ehrlich.