Zum Inhalt springen

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.

Das MultiDocker-Hauptfenster: In der Sidebar zeigt der Block „Aktiv“ acme-platform mit seinen zwei lebenden Sessions, darunter die Gruppen ACME CORP und INTERNAL; im Detailbereich steht der Tab „Übersicht“ von acme-platform mit rot pulsierender Status-Aura, weil eine Session arbeitet, dazu die Tab-Badges und die aufgeklappten Karten Health und Git.

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:

Das MultiDocker-Popover in der Menüleiste: drei Projekte mit Status-Punkten, Hostnames und Start/Stopp-Schaltern.

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.

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.
  • MdockerService ist der Dach-Service, der jedes CLI-Verb kapselt, Modelle dekodiert und laufende Aktionen für die Fortschritts-UI verfolgt.
  • ProcessRunner ist die einzige Stelle, die Process-Instanzen erzeugt — mit erweitertem PATH (damit brew-installierte Tools gefunden werden) und einem SIGTERM→SIGKILL-Timeout.

Alle Services und ViewModels sind @MainActor, UI-Updates sind also immer thread-sicher.

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.

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.

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.