Zum Inhalt springen

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.

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
mdocker terminal tools # JSON list with availability per tool
mdocker terminal
mdocker terminal new aurora --tool claude # start a Claude Code session
mdocker terminal new aurora --tool claude --sandbox # sandbox mode
mdocker terminal new aurora --tool shell
mdocker terminal list aurora # list sessions
mdocker terminal list --all # every project at once
mdocker terminal kill aurora <session-id> # end one session
mdocker terminal prune aurora # drop dead registry entries

Sessions heißen in tmux mdocker__<project>__<id>, ihr Zustand liegt unter .projects[<name>].sessions[] in der Registry.

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.

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
mdocker terminal exec aurora shop # bash (default) in the shop container
mdocker terminal exec aurora db sh # a specific shell

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:

session paths
mdocker terminal path aurora # show the current start path
mdocker terminal path aurora ./backend # set it
mdocker terminal editor-path aurora ~/Projects/aurora

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.

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.