OMC-Setup

OMC Setup

Dies ist der einzige Befehl, den Sie lernen müssen. Nach der Ausführung läuft alles Weitere automatisch.

Wenn diese Skill aufgerufen wird, führen Sie sofort den untenstehenden Workflow aus. Geben Sie diese Anweisungen nicht nur wieder oder fassen Sie sie zusammen.

Hinweis: Alle Pfade vom Typ ~/.claude/... in dieser Anleitung berücksichtigen CLAUDE_CONFIG_DIR, wenn diese Umgebungsvariable gesetzt ist.

Beste Verwendung

Wählen Sie diesen Setup-Ablauf, wenn der Benutzer OMC selbst installieren, aktualisieren oder reparieren möchte.

• Benutzer von Marketplace/Plugin-Installationen sollten hier landen, nachdem /plugin install oh-my-claudecode ausgeführt wurde
• npm-Benutzer sollten hier landen, nachdem npm i -g oh-my-claude-sisyphus@latest ausgeführt wurde
• Benutzer von lokalen Entwicklungs- und Worktree-Umgebungen sollten hier landen, nachdem das ausgecheckte Repository aktualisiert und das Setup erneut ausgeführt wurde

Flag-Parsing

Prüfen Sie auf Flags im Aufruf des Benutzers:

• --help → Hilfetext anzeigen (siehe unten) und anhalten
• --local → Nur Phase 1 (Ziel=local), dann anhalten
• --global → Nur Phase 1 (Ziel=global), dann anhalten
• --force → Pre-Setup-Prüfung überspringen, vollständiges Setup ausführen (Phase 1 → 2 → 3 → 4)
• Keine Flags → Pre-Setup-Prüfung ausführen, dann bei Bedarf vollständiges Setup durchführen

Hilfetext

Wenn der Benutzer mit --help arbeitet, Folgendes anzeigen und anhalten:

OMC Setup - oh-my-claudecode konfigurieren

VERWENDUNG:
  /oh-my-claudecode:omc-setup           Einrichtungsassistent starten (oder aktualisieren, falls bereits konfiguriert)
  /oh-my-claudecode:omc-setup --local   Lokales Projekt konfigurieren (.claude/CLAUDE.md)
  /oh-my-claudecode:omc-setup --global  Globale Einstellungen konfigurieren (~/.claude/CLAUDE.md)
  /oh-my-claudecode:omc-setup --force   Vollständigen Einrichtungsassistenten erzwingen, auch wenn bereits konfiguriert
  /oh-my-claudecode:omc-setup --help    Diese Hilfe anzeigen

MODI:
  Erstinstallation (keine Flags)
    - Interaktiver Assistent für die Ersteinrichtung
    - Konfiguriert CLAUDE.md (lokal oder global)
    - Richtet HUD-Statuszeile ein
    - Prüft auf Updates
    - Entfernt veraltete Setup-Werte (5.0.0 entfernte defaultExecutionMode) und verweist die MCP-Registrierung auf die native Konfiguration von Claude Code
    - Konfiguriert Team-Mode-Standardwerte (Anzahl der Agenten, Typ, Modell)
    - Falls bereits konfiguriert, wird eine schnelle Aktualisierungsoption angeboten

  Lokale Konfiguration (--local)
    - Ruft den Plugin-lokalen Koordinator über `scripts/setup-claude-md.sh` auf; die Shell validiert die Koordinatorantwort und deren Exit-Status, bevor Nachinstallationsarbeiten durchgeführt werden
    - Meldet vom Koordinator erstellte byteidentische Sicherungskopien nur für Dateien, die geändert werden mussten
    - Projektspezifische Einstellungen
    - Verwenden Sie dies, um die Projektkonfiguration nach OMC-Upgrades zu aktualisieren

  Globale Konfiguration (--global)
    - Ruft den Plugin-lokalen Koordinator über `scripts/setup-claude-md.sh` auf; die Shell validiert die Koordinatorantwort und deren Exit-Status, bevor Nachinstallationsarbeiten durchgeführt werden
    - Meldet vom Koordinator erstellte byteidentische Sicherungskopien nur für geänderte globale Dateien
    - Standardmäßig wird ~/.claude/CLAUDE.md überschrieben, sodass auch einfaches `claude` OMC verwendet
    - Im optionalen Beibehaltungsmodus wird die Basis-`CLAUDE.md` des Benutzers beibehalten und OMC in `CLAUDE-omc.md` für `omc`-Starts installiert
    - Gilt für alle Claude Code-Sitzungen
    - Behält gleichnamige Legacy-Hook-Dateien bei, sofern deren exakter historischer Inhalt nicht unabhängig verifiziert wurde
    - Verwenden Sie dies, um die globale Konfiguration nach OMC-Upgrades zu aktualisieren

  Vollständige erzwungene Einrichtung (--force)
    - Umgeht die Prüfung "bereits konfiguriert"
    - Führt den kompletten Einrichtungsassistenten von Grund auf aus
    - Verwenden Sie dies, wenn Sie Einstellungen neu konfigurieren möchten

BEISPIELE:
  /oh-my-claudecode:omc-setup           # Ersteinrichtung (oder Aktualisierung von CLAUDE.md, falls konfiguriert)
  /oh-my-claudecode:omc-setup --local   # Dieses Projekt aktualisieren
  /oh-my-claudecode:omc-setup --global  # Alle Projekte aktualisieren
  /oh-my-claudecode:omc-setup --force   # Vollständigen Einrichtungsassistenten erneut ausführen

Weitere Informationen: https://github.com/Yeachan-Heo/oh-my-claudecode

Setup-Aufruf

Durchsuchen Sie in dieser Skill nicht eigenständig Plugin-Cache-Verzeichnisse oder wählen Sie ein Plugin-Stammverzeichnis aus. Rufen Sie das Setup-Skript aus dem vom ausgeführten Plugin-Umfeld bereitgestellten Plugin-Stammverzeichnis auf:

bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" <local|global> [overwrite|preserve]

Das Skript ist der alleinige Cache-Auflöser. Es akzeptiert nur vollständige Plugin-Stammverzeichnisse (kanonische docs/CLAUDE.md, Koordinator-Artefakt und wiki-Skill), wählt eine strikte vollständige SemVer-Cache-Version, überprüft den Handsake der kompilierten Quelle und schlägt bei Uneinigkeit über das Koordinatorprotokoll oder den Status fehl. Laden Sie keine Konfiguration herunter oder ändern Sie CLAUDE.md außerhalb dieses Koordinators.

Pre-Setup-Prüfung: Bereits konfiguriert?

KRITISCH: Prüfen Sie vor allem anderen, ob das Setup bereits abgeschlossen wurde. Dadurch wird verhindert, dass Benutzer nach jedem Update den vollständigen Einrichtungsassistenten erneut durchlaufen müssen.

# Prüfen, ob das Setup bereits abgeschlossen wurde
CONFIG_DIR="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
case "$CONFIG_DIR" in
  "~") CONFIG_DIR="$HOME" ;;
  "~/"*) CONFIG_DIR="$HOME/${CONFIG_DIR#\.~/}" ;;
  "~\\"*) CONFIG_DIR="$HOME/${CONFIG_DIR#\.~\\\}" ;;
esac
CONFIG_FILE="$CONFIG_DIR/.omc-config.json"

if [ -f "$CONFIG_FILE" ]; then
  if ! command -v jq >/dev/null 2>&1; then
    echo "FEHLER: jq wird benötigt, um den bestehenden OMC-Setup-Status zu prüfen. Bestehende Konfiguration wurde nicht geändert."
    exit 1
  fi
  if ! SETUP_COMPLETED=$(jq -r '.setupCompleted // empty' "$CONFIG_FILE" 2>/dev/null) \
    || ! SETUP_VERSION=$(jq -r '.setupVersion // empty' "$CONFIG_FILE" 2>/dev/null); then
    echo "FEHLER: Bestehende OMC-Konfiguration ist kein gültiges JSON. Bestehende Konfiguration wurde nicht geändert."
    exit 1
  fi

  if [ -n "$SETUP_COMPLETED" ] && [ "$SETUP_COMPLETED" != "null" ]; then
    echo "OMC-Setup wurde bereits abgeschlossen am: $SETUP_COMPLETED"
    [ -n "$SETUP_VERSION" ] && echo "Setup-Version: $SETUP_VERSION"
    ALREADY_CONFIGURED="true"
  fi
fi

Falls bereits konfiguriert (und kein --force-Flag)

Wenn ALREADY_CONFIGURED wahr ist UND der Benutzer NICHT die Flags --force, --local oder --global übergeben hat:

Verwenden Sie AskUserQuestion, um eine Eingabeaufforderung anzuzeigen:

Frage: "OMC ist bereits konfiguriert. Was möchten Sie tun?"

Optionen:

1. CLAUDE.md aktualisieren und veraltete Setup-Werte entfernen – Installieren Sie die kanonische CLAUDE.md des aktiven Plugins und führen Sie Phase 2 Schritt 2.4 aus, ohne den vollständigen Assistenten erneut zu starten
2. Vollständiges Setup erneut ausführen – Durchlaufen Sie den kompletten Einrichtungsassistenten
3. Abbrechen – Beenden ohne Änderungen

Wenn der Benutzer "CLAUDE.md aktualisieren und veraltete Setup-Werte entfernen" wählt:

• Erkennen, ob eine lokale (.claude/CLAUDE.md) oder globale (~/.claude/CLAUDE.md) Konfiguration existiert
• Wenn lokal vorhanden, ausführen: bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" local
• Wenn nur global vorhanden, ausführen: bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" global
• Führen Sie Phase 2 Schritt 2.4 aus, um den veralteten Schlüssel defaultExecutionMode zu entfernen
• Überspringen Sie alle anderen Schritte nach der Bereinigung
• Erfolg melden und beenden

Wenn der Benutzer "Vollständiges Setup erneut ausführen" wählt:

• Fahren Sie mit der Fortsetzungserkennung unten fort

Wenn der Benutzer "Abbrechen" wählt:

• Beenden ohne Änderungen

Überschreibung durch das Force-Flag

Wenn der Benutzer das --force-Flag übergibt, überspringen Sie diese Prüfung und fahren Sie direkt mit dem Setup fort.

Fortsetzungserkennung

Prüfen Sie vor Beginn einer Phase, ob ein vorhandener Zustand besteht:

bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh" resume

Wenn ein Zustand existiert (Ausgabe ist nicht "fresh"), verwenden Sie AskUserQuestion, um eine Eingabeaufforderung anzuzeigen:

Frage: "Es wurde eine vorherige Setup-Sitzung gefunden. Möchten Sie fortsetzen oder neu beginnen?"

Optionen:

1. Weiter bei Schritt $LAST_STEP – Dort fortsetzen, wo Sie aufgehört haben
2. Neu beginnen – Von vorne beginnen (gespeicherten Zustand löschen)

Wenn der Benutzer "Neu beginnen" wählt:

bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh" clear

Phasenausführung

Bei --local- oder --global-Flags:

Lesen Sie die Datei unter ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/01-install-claude-md.md und befolgen Sie deren Anweisungen. (Die Phasendatei behandelt den vorzeitigen Ausstieg für den Flag-Modus.)

Bei vollständigem Setup (Standard oder --force):

Führen Sie die Phasen nacheinander aus. Lesen Sie für jede Phase die entsprechende Datei und befolgen Sie deren Anweisungen:

1. Phase 1 – CLAUDE.md installieren: Lesen Sie ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/01-install-claude-md.md und befolgen Sie deren Anweisungen.

2. Phase 2 – Umgebungskonfiguration: Lesen Sie ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/02-configure.md und befolgen Sie deren Anweisungen. Phase 2 muss die HUD/statusLine-Einrichtung an die hud-Skill delegieren; generieren oder patchen Sie hier keine statusLine-Pfade direkt.

3. Phase 3 – Integrationseinrichtung: Lesen Sie ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/03-integrations.md und befolgen Sie deren Anweisungen.

4. Phase 4 – Abschluss: Lesen Sie ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/04-welcome.md und befolgen Sie deren Anweisungen.

Graceful-Interrupt-Behandlung

WICHTIG: Dieser Setup-Prozess speichert den Fortschritt nach jeder Phase über ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh. Bei Unterbrechung (Ctrl+C oder Verbindungsabbruch) kann das Setup ab der letzten Position fortgesetzt werden.

Auf dem neuesten Stand bleiben

Nach der Installation von oh-my-claudecode-Updates (über npm oder Plugin-Update):

Automatisch: Führen Sie einfach /oh-my-claudecode:omc-setup aus – es erkennt, dass Sie bereits konfiguriert sind, und bietet eine schnelle Option "CLAUDE.md aktualisieren und veraltete Setup-Werte entfernen" an, die den Rest des Assistenten überspringt.

Der schnelle Aktualisierungspfad muss weiterhin Phase 2 Schritt 2.4 ausführen, damit Upgrades den veralteten Wert defaultExecutionMode entfernen; er darf keinen Ersatz-Execution-Mode-Wert schreiben.

Manuelle Optionen:

• /oh-my-claudecode:omc-setup --local, um nur die Projektkonfiguration zu aktualisieren
• /oh-my-claudecode:omc-setup --global, um nur die globale Konfiguration zu aktualisieren
• /oh-my-claudecode:omc-setup --force, um den vollständigen Assistenten erneut auszuführen (Einstellungen neu konfigurieren)

So stellen Sie sicher, dass Sie die neuesten Funktionen und Agentenkonfigurationen haben, ohne die Token-Kosten für eine Wiederholung des vollständigen Setups zu tragen.