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.

Was eine Session ist
Abschnitt betitelt „Was eine Session ist“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.
Eine Session anlegen
Abschnitt betitelt „Eine Session anlegen“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 new <name> --tool claudemdocker terminal exec <name> shop # shell into the "shop" servicemdocker 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).
Live-Status
Abschnitt betitelt „Live-Status“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.
Mitteilungen
Abschnitt betitelt „Mitteilungen“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.
Automatische Session-Titel
Abschnitt betitelt „Automatische Session-Titel“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>.
Anhängen in der App
Abschnitt betitelt „Anhängen in der App“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.
Alle AI-Sessions an einem Ort
Abschnitt betitelt „Alle AI-Sessions an einem Ort“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.

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 überleben das Beenden der App
Abschnitt betitelt „Sessions überleben das Beenden der App“Sandbox-Modus
Abschnitt betitelt „Sandbox-Modus“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:
mdocker terminal new <name> --tool claude --sandboxAufräumen
Abschnitt betitelt „Aufräumen“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.