AI-Terminal-Sessions
MultiDocker kann projektbezogene Terminal-Sessions starten, in denen ein
AI-Coding-Tool, eine einfache Shell oder eine Shell in einem Container des
Projekts läuft. Jede Session ist eine abgekoppelte tmux-Session — sie läuft
also weiter, wenn du die App schließt, und du kannst dich später wieder
anhängen.
Verfügbare Tools
Abschnitt betitelt „Verfügbare Tools“| Tool | Was es startet |
|---|---|
claude |
Claude Code (claude, im Sandbox-Modus claude --sandbox). |
copilot |
GitHub Copilot CLI (gh copilot, wenn die Extension installiert ist, sonst copilot). |
shell |
Deine Login-Shell im Projektverzeichnis. |
exec |
Eine Shell in einem Projekt-Container über docker compose exec. |
Prüfe, welche Tools auf deinem Rechner installiert sind:
mdocker terminal tools # JSON list with availability per toolSessions anlegen und verwalten
Abschnitt betitelt „Sessions anlegen und verwalten“mdocker terminal new aurora --tool claude # start a Claude Code sessionmdocker terminal new aurora --tool claude --sandbox # sandbox modemdocker terminal new aurora --tool shellmdocker terminal list aurora # list sessionsmdocker terminal list --all # every project at oncemdocker terminal kill aurora <session-id> # end one sessionmdocker terminal prune aurora # drop dead registry entriesSessions heißen in tmux mdocker__<project>__<id>, ihr Zustand liegt unter
.projects[<name>].sessions[] in der Registry.
Live-Status der Sessions
Abschnitt betitelt „Live-Status der Sessions“terminal list ermittelt alive live und liest für jede lebende Session drei
zusätzliche Felder direkt aus tmux:
| Feld | Quelle | Bedeutung |
|---|---|---|
activity |
#{window_activity} |
Epoch der letzten Aktivität im Pane. Neue Ausgabe hält den Wert frisch — daraus wird abgeleitet, ob „das Tool gerade arbeitet“. |
exited |
#{pane_dead} |
true, sobald der Prozess des Panes beendet ist (die Session bleibt dank remain-on-exit erhalten). |
title |
#{pane_title} |
Der Titel, den das laufende Programm über OSC 0/2 gesetzt hat — null, wenn leer oder nur der Hostname-Default. |
terminal list --all liefert in einem Aufruf alle Projekte mit Sessions, als
[{ project, sessions: [...] }]. Projekte ohne Sessions werden übersprungen, um
die Antwort klein zu halten. Genau diesen einen Befehl pollt die App.
Container-Shell (exec)
Abschnitt betitelt „Container-Shell (exec)“Um eine Shell in einem laufenden Container zu öffnen, nimm terminal exec. Es
baut den passenden docker compose exec-Aufruf für den COMPOSE_FILE-Stack des
Projekts:
mdocker terminal exec aurora shop # bash (default) in the shop containermdocker terminal exec aurora db sh # a specific shellWo Sessions starten
Abschnitt betitelt „Wo Sessions starten“Standardmäßig öffnet sich eine Session im Projektverzeichnis. Du kannst pro
Projekt einen Startpfad setzen (absolut, ~/-relativ oder relativ zum Projekt)
und davon getrennt einen Pfad zum Öffnen im Editor:
mdocker terminal path aurora # show the current start pathmdocker terminal path aurora ./backend # set itmdocker terminal editor-path aurora ~/Projects/auroraIn der macOS-App
Abschnitt betitelt „In der macOS-App“Die App listet die Sessions eines Projekts und hängt sich über SwiftTerm daran. Weil es echte tmux-Sessions sind, überleben sie das Beenden der App und lassen sich später wieder anhängen.
Aus activity und exited leitet die App drei Zustände ab, jeder mit eigener
Farbe und eigenem Glow: „arbeitet“ (rot, activity jünger als 3 Sekunden),
„wartet auf Eingabe“ (orange, blinkend) und „beendet“ (grau). Sie pollt
terminal list --all alle 2 Sekunden, solange die App im Vordergrund ist, sonst
alle 5 Sekunden — und nur so lange eine Session lebt. Wechselt eine Session von
arbeitend auf wartend oder beendet, zeigt macOS eine Mitteilung — außer die
Session ist gerade geöffnet.
Der Session-Header zeigt den Auto-Titel aus title (oder live aus SwiftTerm)
plus eine Status-Kapsel. „Alle AI-Sessions“ in der Seitenleiste sammelt alle
Sessions über alle Projekte hinweg in den Sektionen „Arbeitet“, „Wartet auf
Eingabe“ und „Beendet“.
Siehe Angehängte Terminals.
Sessions mit einem Ticket als Kontext
Abschnitt betitelt „Sessions mit einem Ticket als Kontext“Ist ein Projekt an ein Spedy-Board gebunden, startet
mdocker spedy session <name> <id> eine claude-Session, deren Initial-Prompt
auf eine generierte Kontextdatei zu diesem Ticket zeigt; in der App ist dieselbe
Aktion der Button „AI-Session mit Ticket-Kontext“ in der Ticket-Detailansicht.
So eine Session trägt zusätzlich spedy_ticket in der Registry. Siehe
Spedy-Tickets.
Verwandt
Abschnitt betitelt „Verwandt“- CLI:
terminal - CLI:
spedy - Angehängte Terminals (SwiftTerm)