Benutzerhandbuch

Erste Schritte

Diagrix ist eine native macOS-App für strukturierte Projektplanung. Sie kombiniert dreizehn Diagramm- und Analyse-Module in einem einzigen Fenster, speichert Dokumente in einem offenen JSON-Format (.diagrix) und stellt einen MCP-Server bereit, über den KI-Assistenten direkt auf die Inhalte zugreifen können.

Systemanforderungen

App starten

Die App wird als macOS-Anwendungspaket gestartet. Beim ersten Start öffnet sich ein leeres Dokument mit dem SWOT-Modul. In der linken Seitenleiste wählst du das gewünschte Modul aus.

Hauptfenster

Das Hauptfenster besteht aus drei Bereichen: Toolbar (oben), Seitenleiste (links) und Modul-Inhalt (rechts).

Toolbar

Seitenleiste

Klick auf ein Modul wechselt die Ansicht sofort. Wer ein Modul mit der Maus überfährt, sieht als Tooltip eine Kurzbeschreibung. Unten in der Seitenleiste befindet sich die Sprachauswahl — wechselt zwischen Englisch, Deutsch und Französisch ohne Neustart — sowie die installierte Version (z. B. „Diagrix 1.0.0.171").

Dokumente

Neu, Öffnen, Speichern

Dokumente werden im Format .diagrix gespeichert (JSON). Jede Datei enthält genau ein aktives Modul.

Auto-Speichern

Wenn eine Datei bereits gespeichert wurde, speichert die App automatisch alle 2 Minuten, sofern ungesicherte Änderungen vorhanden sind.

Einstellungen ⌘,

Die Einstellungen öffnen sich als Sheet über den ⚙-Button in der Toolbar oder per ⌘,. Sie enthalten fünf Bereiche.

Erscheinungsbild

Wähle zwischen System (folgt macOS), Hell und Dunkel.

Diagramm-Theme

Sechs Farbpaletten bestimmen, welche Farben neue Knoten in Flowchart, UML und ERD automatisch erhalten:

Raster

Das Raster gilt für: Flowchart, UML, ERD, C4, Arc42-Diagramm, MindMap.

Module verwalten

Aktiviert oder deaktiviert einzelne Module. Mindestens ein Modul muss aktiv bleiben; MindMap ist immer aktiv.

Sprachen exportieren & importieren

Diagrix liefert Deutsch, Englisch und Französisch mit. Über Einstellungen → Sprachen lassen sich weitere Sprachen als Excel-Datei (.xlsx) hinzufügen oder bestehende korrigieren — ohne Programmierung.

Leere Zielfelder werden automatisch mit der englischen Übersetzung gefüllt. Nicht zuordenbare Schlüssel und alle Englisch-Fallbacks werden in einer Log-Datei neben der Excel-Datei protokolliert.

Sprachen der Hilfe (Hilfe-Pakete)

Die In-App-Hilfe ist auf Deutsch eingebaut. Im Hilfe-Fenster (oben rechts) gibt es einen Sprach-Picker und ein •••-Menü mit Export/Import — analog zu den Oberflächen-Sprachen, aber als eigene .xlsx-Hilfe-Pakete. Fertige Pakete (z. B. Englisch) findest du im Download-Bereich.

Ein Hilfe-Paket gilt nur für die passende App-Version; fehlende Texte fallen automatisch auf Deutsch zurück.

Schriftart pro Diagramm-Typ

Klicke auf das Aa-Symbol in der Modul-Toolbar. Es öffnet sich ein Popover:

Canvas-Bedienung

Die folgenden Interaktionen gelten für alle Canvas-Module: Flowchart, C4, ERD, UML, Arc42-Diagramm.

Auswahl & Drag

Tastatur

Navigation & Zoom

Rechtsklick-Kontextmenü

• Kein Element selektiert — Alles auswählen, Auto-Layout
• 1 Element selektiert — Duplizieren, Löschen
• Mehrfachselektion — N Elemente löschen

Inline-Bearbeitung

• Doppelklick auf Knoten → Beschriftung direkt auf dem Canvas bearbeiten
• Enter oder Klick außerhalb → Änderung übernehmen
• Escape → Änderung verwerfen

Kollisionserkennung

In Flowchart, UML, ERD, C4 und Arc42-Diagramm wird beim Drag verhindert, dass Formen sich überlappen:

• Gleiten entlang der Kante: Wenn eine Achse blockiert ist, kann die andere noch genutzt werden
• Bereits überlappende Formen (z.B. via MCP platziert) können sich frei herausbewegen
• Visuelles Feedback: Blockierende Formen werden kurz mit einem roten gestrichelten Rahmen markiert

Kanten, Wegpunkte & Beschriftung

Alle Diagramm-Module mit Verbindungen unterstützen individuelle Kantenstile. Kante auswählen → Stil-Editor erscheint im rechten Properties-Panel.

Kantenstil

Wegpunkte

Wegpunkte formen den Kantenverlauf frei. Sie sind als weiße Kreise mit farbigem Rand sichtbar und liegen immer im Vordergrund — auch wenn sie auf einem Knoten liegen.

Wegpunkte sind verfügbar in: Flowchart, UML, ERD, C4, Arc42-Diagramm, BPMN.

Beschriftung

Kanten lassen sich direkt auf dem Canvas beschriften. Das Label sitzt standardmäßig mittig auf der Kante und kann frei verschoben werden — der Versatz erscheint identisch im PNG/JPEG- und HTML-Export.

Beschriftung verfügbar in allen Kanten-Modulen: Flowchart, UML, ERD, C4, Arc42-Diagramm, BPMN, Sequenzdiagramm.

Auto-Layout

In Flowchart, UML, ERD, C4 und Arc42-Diagramm ordnet der Auto-Button in der Toolbar alle Elemente automatisch an.

Ablauf

1. Klick auf Auto in der Toolbar (oder Rechtsklick → Auto-Layout)
2. Die Layout-Engine analysiert die Graphstruktur
3. Enthält der Graph keine Zyklen → hierarchisches Schichten-Layout (Sugiyama)
4. Enthält der Graph Zyklen → kräftebasiertes Layout (Fruchterman-Reingold)
5. Nach dem Layout werden Gruppen komprimiert und verbleibende Überlappungen aufgelöst

Gruppen

Gruppen sind in Flowchart, UML, ERD, C4 und Arc42 verfügbar. Sie dienen dazu, zusammengehörige Elemente visuell zu umschließen und zu beschriften.

Erstellen

Klick auf Gruppe in der Toolbar, dann auf dem Canvas einen Bereich aufziehen.

Eigenschaften

Containment

Ein Element gehört automatisch zu einer Gruppe, wenn sein Mittelpunkt innerhalb des Gruppenrechtecks liegt. Das Auto-Layout hält enthaltene Elemente zusammen.

1. MindMap

Hierarchische Gedankenkarte mit unbegrenzter Tiefe, Cross-Links, Themes und Inline-Editing.

Rechtes Panel: Label, Notizen, Textausrichtung, Theme. Auto-Layout via Auto-Button.

2. SWOT-Analyse

Klassische 2×2-Matrix für Stärken, Schwächen, Chancen und Risiken.

• +-Button in der Quadranten-Kopfzeile → Neuen Eintrag hinzufügen
• ×-Button beim Hovern → Eintrag löschen
• Änderungen werden beim Verlassen des Feldes automatisch gespeichert

3. Business Model Canvas

Neun Sektionen des Business Model Canvas mit direkter Inline-Eingabe.

• +-Button in der Sektions-Kopfzeile → Neuen Eintrag hinzufügen
• Änderungen werden beim Verlassen des Feldes automatisch gespeichert

4. Kanban-Board

Professionelles Kanban-Board mit Sprint-Planung, Swimlanes, Zeiterfassung und bidirektionaler Gantt-Synchronisation.

• Karten per Drag & Drop zwischen Spalten verschieben
• Neue Karte → Titelfeld sofort editierbar
• Prioritäten: Niedrig / Mittel / Hoch / Kritisch
• Tags als Freitext-Chips
• Optionales WIP-Limit pro Spalte
• Spalten per Doppelklick auf Titel umbenennen
• Sprint-Labels, Swimlanes und Abhängigkeiten (blockiert / blockiert durch)
• Zeiterfassung: Geschätzt / Gebucht
• Bidirektionale Synchronisation mit dem Gantt-Diagramm

5. Gantt-Diagramm

Interaktiver Gantt-Chart mit Drag-to-Move, Zoom-Stufen und bidirektionaler Kanban-Synchronisation.

Rechtes Panel: Name, Starttag, Dauer, Farbe.

6. Fischgräten-Diagramm (Ishikawa)

Ursache-Wirkungs-Diagramm mit konfigurierbaren Kategorien.

• + Oben / + Unten → Neue Kategorie hinzufügen
• System-Picker → 6M, 4M, 4P oder benutzerdefiniert
• Klick auf Kategorie → Ursachen im rechten Panel bearbeiten
• Kategorie-Labels und Ursachen speichern bei Fokusverlust
• Drag auf Kategorie-Label → Kategorie entlang der Wirbelsäule verschieben; das Ursachen-Layout passt sich automatisch an

7. Sequenzdiagramm

Teilnehmer und Nachrichten in zeitlicher Reihenfolge.

Nachrichtentypen: Synchron (→), Asynchron (⇢), Rückgabe (--→). Von/Nach-Felder verhindern denselben Teilnehmer als Quelle und Ziel.

8. arc42

Vollständige arc42-Vorlage mit 12 Kapiteln, Status-Tracking und integriertem Diagramm-Editor.

• Kapitel-Status: Leer / Entwurf / Fertig
• Jedes Kapitel hat drei Tabs: Text, Vorschau und Diagramm
• Vorschau-Tab — Live-Rendering des Markdown-Textes (Überschriften, Listen, Codeblöcke, Fett/Kursiv)
• Kapitel-Diagramme: Vollständige Canvas-Bedienung mit allen Shortcuts
• Drag-to-Connect: im Verbindungs-Modus Knoten per Drag verbinden — Rubber-Band-Linie zeigt den Verbindungsverlauf
• Auto-Button in der Diagramm-Toolbar: Knoten automatisch anordnen
• Gruppe-Button: Gruppenrechteck oder -ellipse anlegen

9. Flowchart

Ablaufdiagramme nach ISO 5807 mit vollständiger Canvas-Bedienung.

• Verbindungs-Modus: Button „Verbindung", dann Quelle → Ziel klicken
• Kanten mit optionalem Label
• Auto-Button: Knoten automatisch anordnen
• Gruppe-Button: Gruppenrechteck oder -ellipse anlegen
• Shape-Palette (rechts): Formen per Drag & Drop auf den Canvas ziehen

10. C4-Modell

Hierarchisches Architekturmodell mit Kontext-, Container- und Komponentendiagrammen.

• Mehrere Diagramme pro Dokument (Kontext → Container → Komponente)
• Shape-Palette (rechts): Formen per Drag & Drop auf den Canvas ziehen — automatisch auf die aktive Ebene begrenzt (Kontext: 4, Container: 8, Komponente: 6 Formen)
• Ebenen-Verlinkung: „Verweist auf Ebene" im Properties Panel → Rechtsklick → „Zur verweisenden Ebene"

11. ER-Diagramm

Entity-Relationship-Modell in relationaler und Chen-Notation.

• Spalten: Name, Typ, PK / NOT NULL / UNIQUE
• Kardinalitäten: 1, n, 0..1, 0..n, 1..n
• Auto-Button: Entitäten automatisch anordnen
• Shape-Palette (rechts): Formen per Drag & Drop auf den Canvas ziehen

12. UML-Diagramm

Klassen-, Objekt-, Komponenten- und State-Machine-Diagramme.

• Beziehungen: Assoziation, Abhängigkeit, Generalisierung, Realisierung, Komposition, Aggregation
• Attribute und Methoden bearbeitbar (eine pro Zeile)
• Auto-Button: Knoten automatisch anordnen
• Shape-Palette (rechts): Formen per Drag & Drop auf den Canvas ziehen

13. BPMN-Prozess

Geschäftsprozessdiagramme nach BPMN 2.0 (ISO 19510) — Standard für ERP-Modellierung.

• Verbinden-Button + Typauswahl (Sequenz / Nachricht / Assoziation) in der Toolbar
• Auto-Button: Elemente automatisch anordnen (Pools und Lanes bleiben fixiert)

In-App-Hilfe

Die vollständige Hilfe ist direkt in der App verfügbar: Menü Hilfe → Diagrix Hilfe (oder über den Hilfe-Menüpunkt in der macOS-Menüleiste).

Das Hilfefenster öffnet sich als eigenständiges Fenster und kann offen bleiben, während man in der App arbeitet.

Export

MCP-Server

Diagrix startet automatisch einen lokalen MCP-Server (Standard-Port 3001). KI-Assistenten wie Claude können damit direkt auf alle 13 Module zugreifen — lesen, erstellen, bearbeiten, löschen. Standardmäßig ist der Server nur auf dem eigenen Mac erreichbar (Bindung an 127.0.0.1).

Server-Einstellungen

Unter Einstellungen → MCP-Server:

Sicherheit: Der Server hat keine eingebauten Grenzen und kann Dokumente verändern. Bei externem Zugriff den Token geheim halten.

Verbindung einrichten (Claude Desktop)

{
  "mcpServers": {
    "diagrix": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:3001/sse"
      ]
    }
  }
}

Verfügbare Tool-Kategorien