Die macOS-App
Zu MultiDocker gehört eine native SwiftUI-App für macOS 14+. Sie ist ein grafisches
Frontend über derselben Engine, die auch das CLI nutzt — keine Neuimplementierung. Jede
Aktion in der App ruft das mdocker-Binary auf und dekodiert dessen --json-Ausgabe.

Die App lebt außerdem in der Menüleiste. Das Popover zeigt dir den Zustand jedes Projekts und einen Schalter zum Starten oder Stoppen, ohne das Hauptfenster nach vorne zu holen:

Was sie ist
Abschnitt betitelt „Was sie ist“Die App kapselt das CLI über Swifts Process-API. Wenn du bei einem Projekt auf „Starten“
klickst, läuft mdocker up <name>; für die Projektliste wird mdocker ls --json geparst.
Das heißt:
- App und CLI können im Verhalten nie auseinanderlaufen — es gibt genau eine Implementierung pro Verb.
- Alles, was die App tut, kannst du auf der Kommandozeile nachvollziehen (und skripten).
- Die App legt Darstellung und Orchestrierung obendrauf: eine Sidebar mit „Aktiv“-Block und klappbaren Gruppen, eine Detailseite mit Tabs, einen Tickets-Tab für Spedy, eine globale AI-Session-Übersicht mit Live-Status, eine Status-Aura, die auf laufende Arbeit reagiert, eingebettete Terminals, einen Profil-Editor und einen Assistenten für den ersten Start.
Wie sie gebaut ist
Abschnitt betitelt „Wie sie gebaut ist“Die App folgt einer MVVM-Struktur mit Dependency Injection:
View ──► ViewModel ──► Service ──► ProcessRunner ──► mdocker │ └──► Storage (preferences, logs, wizard state)- Views sind dumm — sie beobachten
@Published-State und schicken Aktionen nach oben. - ViewModels halten den Feature-State und orchestrieren die Service-Aufrufe.
MdockerServiceist der Dach-Service, der jedes CLI-Verb kapselt, Modelle dekodiert und laufende Aktionen für die Fortschritts-UI verfolgt.ProcessRunnerist die einzige Stelle, dieProcess-Instanzen erzeugt — mit erweitertem PATH (damitbrew-installierte Tools gefunden werden) und einem SIGTERM→SIGKILL-Timeout.
Alle Services und ViewModels sind @MainActor, UI-Updates sind also immer thread-sicher.
Was du im Fenster bekommst
Abschnitt betitelt „Was du im Fenster bekommst“| Bereich | Was er zeigt |
|---|---|
| Sidebar | Eine Kopfzeile „Projekte“ mit Zähler und einem Button „Hinzufügen“, eine Zeile „Alle AI-Sessions“, einen Block „Aktiv“ mit jedem Projekt, das eine lebende Session hat, und klappbare Gruppen-Abschnitte. Fährst du über eine Projektzeile, wird aus dem Profil-Badge ein „+“, das eine neue AI-Session startet. Ein Footer-Eintrag öffnet den globalen Profil-Editor. |
| Detailbereich | Eine sticky Kopfzeile (Name, Status, Profil-Badge, URL, Aktionen) über einer Status-Aura, dazu eine Glas-Tab-Leiste mit vier Tabs: „Übersicht“ (⌘1), „Services“ (⌘2), „Tickets“ (⌘3) und „Einstellungen“ (⌘4). |
| Toolbar / Menüleiste | Ein Doctor-Button, Aktualisieren, Einstellungen und ein EDGE-Badge, das rot wird, wenn der Edge-Stack unten ist. |
| Konsole | Eine klappbare Konsole am unteren Rand, die jeden von der App ausgeführten Befehl mit Ausgabe und Exit-Code zeigt. |
Verhältnis zum CLI
Abschnitt betitelt „Verhältnis zum CLI“Die App ist optional. Du kannst alles im Terminal mit mdocker erledigen. Im Alltag bringt
sie aber echten Mehrwert: Gesundheit auf einen Blick, Starten und Stoppen mit einem Klick,
eingebettete Terminals, die das Beenden der App überleben, einen Profil-Editor mit
Validierung und Spedy-Tickets direkt neben dem Projekt, zu dem
sie gehören.
Demo-Modus
Abschnitt betitelt „Demo-Modus“Unter Einstellungen → Demo-Modus zeigt die App fiktive Daten: die Projekte der Acme Corp, AI-Sessions in allen Zuständen, Spedy-Tickets, Git-Stände, Datenbank-Snapshots und Konfiguration. Docker, tmux, Git und die Spedy-API werden dabei nicht angesprochen, deine echten Projekte bleiben unverändert. Gedacht ist der Modus für Screenshots, Produktvideos und Vorführungen. Ein DEMO-Badge neben dem EDGE-Badge zeigt, dass der Modus aktiv ist. Für Screenshots lässt sich das Badge ausblenden.
Für einen einzelnen Start ohne Umstellen der Einstellung startest du die App mit
open -a MultiDocker --args --demo. Im Terminal liefert MD_DEMO=1 mdocker … dieselben
Daten.
Weiterlesen
Abschnitt betitelt „Weiterlesen“- Installation & Runtime-Modell — wie die mitgelieferte Runtime funktioniert.
- Sidebar & Projekt-Detail — eine Tour durch die Haupt-UI.
- Angehängte Terminals — eingebettete tmux-Sessions über SwiftTerm.