Sidebar & Projekt-Detail
Das Hauptfenster ist eine klassische geteilte Ansicht: links eine Sidebar mit deinen Projekten, rechts eine Detailansicht mit Tabs für das ausgewählte Projekt.

Die Sidebar
Abschnitt betitelt „Die Sidebar“Von oben nach unten enthält die Sidebar:
- Eine Kopfzeile „Projekte“ mit Zähler und einem Button „Hinzufügen“, der ein bestehendes Compose-Projekt registriert (Scan oder manuell).
- Eine Zeile „Alle AI-Sessions“ (Icon sparkles) mit einem Zähler der lebenden Sessions und einem roten Puls-Dot, solange eine Session arbeitet. Sie öffnet die globale Session-Übersicht.
- Den Block „Aktiv“.
- Die Gruppen-Abschnitte.
- Einen Footer-Eintrag „Profile“, der den globalen Profil-Editor öffnet, mit einem Live-Zähler der vorhandenen Profile.
Der „Aktiv“-Block
Abschnitt betitelt „Der „Aktiv“-Block“Jedes Projekt, das gerade mindestens eine lebende Session hat (alive und nicht beendet), wird nach oben in den „Aktiv“-Block gehoben: die Projektzeile plus ihre lebenden Sessions, darunter eingerückt. Der Block ist nicht klappbar, er wächst nie über 42 % der Sidebar-Höhe hinaus und scrollt darüber hinaus für sich allein; sein Header trägt denselben roten Puls-Dot, wenn eine Session arbeitet.
Gruppen
Abschnitt betitelt „Gruppen“Unterhalb von „Aktiv“ sind die Projekte gruppiert. Die Gruppen-Abschnitte sind alphabetisch sortiert, ungruppierte Projekte stehen zuletzt unter „Weitere“. Hat kein einziges Projekt eine Gruppe, fällt die Sidebar auf eine flache Liste ohne Header zurück.
Ein Gruppen-Header hat einen 3 pt breiten Verlaufsbalken und wechselt als Tooltip zwischen
„Gruppe ausklappen“ und „Gruppe einklappen“. Der Klappzustand wird in
~/.multidocker/preferences/preferences.json unter collapsedGroups gespeichert, die Sidebar
sieht nach einem Neustart also genauso aus.
Gruppen werden pro Projekt zugeordnet — über das Kontextmenü weiter unten, über die Karte
„Gruppe“ im Tab Einstellungen oder per CLI mit mdocker group set. Siehe
Projekt-Gruppen.
Die Projektzeile
Abschnitt betitelt „Die Projektzeile“Jede Zeile zeigt einen Status-Punkt, den Projektnamen, seinen primären Hostnamen in Monospace-Schrift und ein Profil-Badge — „Shopware“, „API + Web“, „Generic“ oder den Profilnamen für alles andere.
Wenn du die Zeile überfährst, ersetzt ein „+“ im Marken-Verlauf das Badge, mit dem Tooltip „Neue AI-Session erstellen“. Es öffnet direkt das Sheet für die neue Session, ohne Umweg über die Detailansicht.
Kontextmenü
Abschnitt betitelt „Kontextmenü“Ein Rechtsklick auf eine Projektzeile bietet, in dieser Reihenfolge:
- „Stoppen“ und „Neustart“ bei einem laufenden Projekt, „Starten“ bei einem gestoppten
- „Im Browser öffnen“
- „Pfad im Finder zeigen“
- das Untermenü „Gruppe“ — jede vorhandene Gruppe als Häkchen-Eintrag, dann „Keine Gruppe“, dann „Neue Gruppe …“, was ein Sheet mit dem Titel „Neue Gruppe“ öffnet, mit dem Feld „Gruppenname“ und den Buttons „Abbrechen“ und „Anlegen“
- „Auswählen, um umzubenennen“
- „Aus Liste entfernen …“

Die Detailansicht
Abschnitt betitelt „Die Detailansicht“Wählst du ein Projekt aus, erscheint eine sticky Kopfzeile — Name, Status, Profil-Badge, URL und die Lifecycle-Aktionen (⌘R startet das Projekt) — über einer gläsernen Tab-Leiste.
Status-Aura
Abschnitt betitelt „Status-Aura“Hinter der Kopfzeile liegt eine Status-Aura, die dir ohne ein einziges Label sagt, was das Projekt gerade tut:
| Aura | Bedeutung |
|---|---|
| aus | das Projekt ist gestoppt |
| grün, statisch | das Projekt läuft |
| rot, pulsierend (1,6 s) | eine Session in diesem Projekt arbeitet — das schlägt grün |
Der Puls respektiert die Systemeinstellung Bewegung reduzieren.
Die vier Tabs
Abschnitt betitelt „Die vier Tabs“| Tab | Kurzbefehl | Badge |
|---|---|---|
| „Übersicht“ | ⌘1 | roter Puls-Dot, solange eine Session arbeitet |
| „Services“ | ⌘2 | die Anzahl der Services |
| „Tickets“ | ⌘3 | die Anzahl offener Tickets |
| „Einstellungen“ (Kurztitel „Optionen“) | ⌘4 | — |
Der Tab-Wechsel schiebt den Inhalt horizontal hinein.
Tab „Übersicht“
Abschnitt betitelt „Tab „Übersicht““Health, Git, Shopware und AI-Sessions. Die Karten fließen ab 840 pt Inhaltsbreite in zwei Spalten (gedeckelt bei 1200 pt); die Git- und die Shopware-Karte blenden sich aus, wenn sie nicht relevant sind, und das Layout schließt die Lücke.
Health-Karte
Abschnitt betitelt „Health-Karte“Eine Zusammenfassung auf einen Blick aus mdocker health <name> --json: Status des
Edge-Stacks, Container-Zustand je Service und eine HTTP-Probe für jeden Hostnamen. Das ist der
schnellste Weg zu sehen, ob ein Projekt tatsächlich erreichbar ist und nicht nur „läuft“.
Git-Karte
Abschnitt betitelt „Git-Karte“Eine Zusammenfassung aus mdocker git info <name> --json — Branch, Anzahl geänderter Dateien,
ahead/behind, Stash und (ausgeklappt) der letzte Commit, die Remote-URL und Worktrees.
Shopware-Karte
Abschnitt betitelt „Shopware-Karte“Für Shopware-Projekte (Profil shopware-dockware) zeigt sie die Shop-Version, warnt bei
APP_URL-Drift und bietet Buttons für Cache-Clear, Build und den Domain-Sync-Assistenten
für Sales-Channels. Siehe Shopware-Workflows.
AI-Sessions-Karte
Abschnitt betitelt „AI-Sessions-Karte“Die Sessions des Projekts mit ihrem Live-Status, ein Button für eine neue Session und ein Reload-Button. Öffnest du eine Session, hängt sich ein eingebettetes Terminal an — siehe Angehängte Terminals.
Tab „Services“
Abschnitt betitelt „Tab „Services““Ein Akkordeon je Compose-Service mit Zustand, Ports, Umgebungsvariablen (mit maskierten Secrets) und einem kopierfertigen Connection-String für Datenbanken — siehe Datenbanken vom Host aus erreichen — gefolgt von einer Datenbank-Karte mit Snapshots und Dump/Restore-Aktionen. Solange das Projekt gestoppt ist, sagt die Datenbank-Karte „Projekt ist gestoppt - keine Container vorhanden.“
Tab „Tickets“
Abschnitt betitelt „Tab „Tickets““Eine Master-Detail-Ansicht über das Spedy-Board, das dem Projekt zugewiesen ist: links eine 320 pt breite Liste mit der Kopfzeile „Tickets“, einem Zähler und einem Button „Tickets neu laden“, rechts das Ticket-Detail.

- Noch nichts ausgewählt: „Ticket auswählen“.
- Board zugewiesen, aber nichts offen: „Keine offenen Tickets“.
- Noch kein Board: die Karte „Spedy-Board“ plus der Hinweis „Sobald ein Board zugewiesen ist, erscheinen die offenen Tickets hier.“
Tickets werden alle 120 s neu geladen, aber nur solange der Tab „Tickets“ sichtbar ist.
Ein .ticket-Deep-Link öffnet das Projekt, wechselt auf diesen Tab und wählt das Ticket aus.
Tab „Einstellungen“
Abschnitt betitelt „Tab „Einstellungen““Die Einstellungs-Karten pro Projekt, in dieser Reihenfolge:
| Karte | Was sie tut |
|---|---|
| „Hostnames“ | Hostnamen des Projekts hinzufügen, entfernen und öffnen. Änderungen schreiben das Override neu und können das Zertifikat neu erzeugen und den Router neu starten. |
| „Routing“ | Web-Routing je Service (Port, Schema) und das Profil des Projekts. Der Kopfzeilen-Button „Override neu generieren“ baut das Override aus dem aktuellen Compose neu, etwa nachdem du einen Service entfernt hast; dieselbe Aktion steckt im „…“-Menü der Projekt-Kopfzeile. |
| „Pfade“ | Der „AI-Pfad“, in dem eine Session startet, und der „Editor-Pfad“, den der Editor öffnet. |
| „Spedy-Board“ | Das Spedy-Board zuweisen oder entfernen, dessen Tickets den Tab „Tickets“ füllen. |
| „Demo-Link (öffentlich)“ | Einen öffentlichen cloudflared-Demo-Tunnel starten, kopieren, öffnen und stoppen. |
| „Gruppe“ | Die Sidebar-Gruppe dieses Projekts. Leer bedeutet keine Gruppe. |
| „Details“ | Registry-Fakten zum Projekt. |
| „Projekt“ | Das Projekt umbenennen oder aus der Liste entfernen. |

Toolbar, Menubar und Konsole
Abschnitt betitelt „Toolbar, Menubar und Konsole“- Die Toolbar trägt einen Doctor-Button, Aktualisieren, Einstellungen und das EDGE-Badge — ein konstantes Label „EDGE“, grün wenn der Edge-Stack läuft, rot wenn er unten ist. Ein Klick schaltet den Edge-Stack um (denk daran: ihn herunterzufahren stoppt alle Projekte).
- Die App lebt außerdem in der Menubar als kompaktes Popover mit der Projektliste und Schnell-Umschaltern.
- Eine ausklappbare Konsole am unteren Rand protokolliert jeden Befehl, den die App
ausgeführt hat, samt Ausgabe, Exit-Code und Dauer — praktisch, um genau zu sehen, welchen
mdocker-Aufruf ein Klick ausgelöst hat. Die Höhe lässt sich an der Oberkante ziehen (Doppelklick setzt zurück); Einträge lassen sich durchsuchen, nach Fehlern oder Projekt filtern und per Hover-Buttons oder Kontextmenü kopieren bzw. erneut ausführen.