omc-setup

Configuration OMC

C'est la seule commande que vous devez apprendre. Après l'avoir exécutée, tout le reste est automatique.

Quand cette compétence est invoquée, exécutez immédiatement le workflow ci-dessous. Ne vous contentez pas de reformuler ou de résumer ces instructions à l'utilisateur.

Remarque : Tous les chemins ~/.claude/... de ce guide respectent CLAUDE_CONFIG_DIR lorsque cette variable d'environnement est définie.

Cas d'utilisation idéal

Choisissez ce flux de configuration lorsque l'utilisateur souhaite installer, mettre à jour ou réparer OMC lui-même.

• Les utilisateurs de plugins / marché doivent arriver ici après /plugin install oh-my-claudecode
• Les utilisateurs npm doivent arriver ici après npm i -g oh-my-claude-sisyphus@latest
• Les utilisateurs de développement local et de worktree doivent arriver ici après avoir mis à jour le dépôt extrait et réexécuté la configuration

Analyse des drapeaux

Vérifiez les drapeaux dans l'invocation de l'utilisateur :

• --help → Afficher le texte d'aide (ci-dessous) et s'arrêter
• --local → Phase 1 seulement (cible=local), puis s'arrêter
• --global → Phase 1 seulement (cible=global), puis s'arrêter
• --force → Ignorer la vérification pré-configuration, exécuter la configuration complète (Phase 1 → 2 → 3 → 4)
• Aucun drapeau → Exécuter la vérification pré-configuration, puis la configuration complète si nécessaire

Texte d'aide

Quand l'utilisateur exécute avec --help, affichez ceci et arrêtez-vous :

OMC Setup - Configurer oh-my-claudecode

UTILISATION :
  /oh-my-claudecode:omc-setup           Exécuter l'assistant de configuration initiale (ou mettre à jour si déjà configuré)
  /oh-my-claudecode:omc-setup --local   Configurer le projet local (.claude/CLAUDE.md)
  /oh-my-claudecode:omc-setup --global  Configurer les paramètres globaux (~/.claude/CLAUDE.md)
  /oh-my-claudecode:omc-setup --force   Forcer l'assistant de configuration complet même si déjà configuré
  /oh-my-claudecode:omc-setup --help    Afficher cette aide

MODES :
  Configuration initiale (aucun drapeau)
    - Assistant interactif pour la première configuration
    - Configure CLAUDE.md (local ou global)
    - Configure la barre d'état HUD
    - Vérifie les mises à jour
    - Efface les valeurs de configuration obsolètes (5.0.0 a supprimé defaultExecutionMode) et pointe l'enregistrement MCP vers la configuration native de Claude Code
    - Configure les valeurs par défaut du mode équipe (nombre d'agents, type, modèle)
    - Si déjà configuré, propose une option de mise à jour rapide

  Configuration locale (--local)
    - Invoque le coordinateur local du plugin via `scripts/setup-claude-md.sh` ; le shell valide la réponse du coordinateur et son code de sortie avant tout travail post-installation
    - Signale les sauvegardes créées par le coordinateur uniquement pour les fichiers ayant nécessité une mutation
    - Paramètres spécifiques au projet
    - Utilisez ceci pour mettre à jour la configuration du projet après une mise à niveau d'OMC

  Configuration globale (--global)
    - Invoque le coordinateur local du plugin via `scripts/setup-claude-md.sh` ; le shell valide la réponse du coordinateur et son code de sortie avant tout travail post-installation
    - Signale les sauvegardes créées par le coordinateur uniquement pour les fichiers globaux modifiés
    - Par défaut : écrase explicitement ~/.claude/CLAUDE.md pour que `claude` simple utilise aussi OMC
    - Mode préservation optionnel : conserve le `CLAUDE.md` de base de l'utilisateur et installe OMC dans `CLAUDE-omc.md` pour les lancements `omc`
    - S'applique à toutes les sessions Claude Code
    - Conserve les fichiers de hook hérités de même nom sauf si leur contenu historique exact est vérifié indépendamment
    - Utilisez ceci pour mettre à jour la configuration globale après une mise à niveau d'OMC

  Configuration forcée complète (--force)
    - Ignore la vérification "déjà configuré"
    - Exécute l'assistant de configuration complet depuis le début
    - Utilisez lorsque vous souhaitez reconfigurer les préférences

EXEMPLES :
  /oh-my-claudecode:omc-setup           # Première configuration (ou mise à jour de CLAUDE.md si configuré)
  /oh-my-claudecode:omc-setup --local   # Mettre à jour ce projet
  /oh-my-claudecode:omc-setup --global  # Mettre à jour tous les projets
  /oh-my-claudecode:omc-setup --force   # Réexécuter l'assistant de configuration complet

Pour plus d'informations : https://github.com/Yeachan-Heo/oh-my-claudecode

Invocation de la configuration

Ne pas analyser indépendamment les répertoires de cache de plugin ni sélectionner une racine de plugin dans cette compétence. Invoquez le script de configuration à partir de la racine du plugin fournie par l'environnement du plugin en cours d'exécution :

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

Le script est le seul résolveur de cache. Il n'accepte que des racines de plugin complètes (docs/CLAUDE.md canonique, artefact coordinateur et compétence wiki), choisit une version de cache SemVer stricte complète, vérifie la poignée de main de code source compilée et échoue en cas de désaccord sur le protocole ou le statut du coordinateur. Ne pas télécharger de configuration ni modifier CLAUDE.md en dehors de ce coordinateur.

Vérification pré-configuration : Déjà configuré ?

CRITIQUE : Avant de faire quoi que ce soit d'autre, vérifiez si la configuration a déjà été effectuée. Cela évite aux utilisateurs de devoir réexécuter l'assistant complet après chaque mise à jour.

# Vérifier si la configuration a déjà été effectuée
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 "ERREUR : jq est requis pour inspecter l'état de configuration OMC existant. La configuration existante n'a pas été modifiée."
    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 "ERREUR : La configuration OMC existante est un JSON invalide. La configuration existante n'a pas été modifiée."
    exit 1
  fi

  if [ -n "$SETUP_COMPLETED" ] && [ "$SETUP_COMPLETED" != "null" ]; then
    echo "La configuration OMC a déjà été effectuée le : $SETUP_COMPLETED"
    [ -n "$SETUP_VERSION" ] && echo "Version de configuration : $SETUP_VERSION"
    ALREADY_CONFIGURED="true"
  fi
fi

Si déjà configuré (et sans drapeau --force)

Si ALREADY_CONFIGURED est vrai ET que l'utilisateur n'a PAS passé les drapeaux --force, --local ou --global :

Utilisez AskUserQuestion pour demander :

Question : "OMC est déjà configuré. Que souhaitez-vous faire ?"

Options :

1. Mettre à jour CLAUDE.md et effacer les valeurs de configuration obsolètes - Installer le CLAUDE.md canonique du plugin actif et exécuter la Phase 2 Étape 2.4 sans réexécuter la configuration complète
2. Réexécuter la configuration complète - Parcourir l'assistant complet
3. Annuler - Quitter sans modifications

Si l'utilisateur choisit "Mettre à jour CLAUDE.md et effacer les valeurs de configuration obsolètes" :

• Détecter si la configuration locale (.claude/CLAUDE.md) ou globale (~/.claude/CLAUDE.md) existe
• Si la configuration locale existe, exécuter : bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" local
• Si seule la configuration globale existe, exécuter : bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" global
• Exécuter la Phase 2 Étape 2.4 pour effacer la clé obsolète defaultExecutionMode
• Ignorer toutes les autres étapes après le nettoyage
• Signaler le succès et quitter

Si l'utilisateur choisit "Réexécuter la configuration complète" :

• Continuer avec la Détection de reprise ci-dessous

Si l'utilisateur choisit "Annuler" :

• Quitter sans aucune modification

Surcharge du drapeau --force

Si l'utilisateur passe le drapeau --force, ignorer cette vérification et procéder directement à la configuration.

Détection de reprise

Avant de commencer toute phase, vérifiez l'état existant :

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

Si un état existe (la sortie n'est pas "fresh"), utilisez AskUserQuestion pour demander :

Question : "Une session de configuration précédente a été trouvée. Souhaitez-vous reprendre ou recommencer ?"

Options :

1. Reprendre à l'étape $LAST_STEP - Continuer là où vous vous étiez arrêté
2. Recommencer - Commencer depuis le début (efface l'état sauvegardé)

Si l'utilisateur choisit "Recommencer" :

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

Exécution des phases

Pour les drapeaux --local ou --global :

Lisez le fichier ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/01-install-claude-md.md et suivez ses instructions. (Le fichier de phase gère la sortie anticipée pour le mode drapeau.)

Pour la configuration complète (par défaut ou --force) :

Exécutez les phases séquentiellement. Pour chaque phase, lisez le fichier correspondant et suivez ses instructions :

1. Phase 1 - Installer CLAUDE.md : Lisez ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/01-install-claude-md.md et suivez ses instructions.

2. Phase 2 - Configuration de l'environnement : Lisez ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/02-configure.md et suivez ses instructions. La Phase 2 doit déléguer la configuration HUD/statusLine à la compétence hud ; ne générez ni ne corrigez les chemins statusLine en ligne ici.

3. Phase 3 - Configuration des intégrations : Lisez ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/03-integrations.md et suivez ses instructions.

4. Phase 4 - Achèvement : Lisez ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/04-welcome.md et suivez ses instructions.

Gestion gracieuse des interruptions

IMPORTANT : Ce processus de configuration sauvegarde la progression après chaque phase via ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh. En cas d'interruption (Ctrl+C ou perte de connexion), la configuration peut reprendre là où elle s'était arrêtée.

Rester à jour

Après avoir installé les mises à jour de oh-my-claudecode (via npm ou mise à jour de plugin) :

Automatique : Exécutez simplement /oh-my-claudecode:omc-setup - il détectera que vous avez déjà configuré et proposera une option rapide "Mettre à jour CLAUDE.md et effacer les valeurs de configuration obsolètes" qui ignore le reste de l'assistant.

Le chemin de mise à jour rapide doit toujours effectuer la Phase 2 Étape 2.4 pour que les mises à niveau suppriment la valeur obsolète defaultExecutionMode ; il ne doit écrire aucun paramètre de mode d'exécution de remplacement.

Options manuelles :

• /oh-my-claudecode:omc-setup --local pour mettre à jour uniquement la configuration du projet
• /oh-my-claudecode:omc-setup --global pour mettre à jour uniquement la configuration globale
• /oh-my-claudecode:omc-setup --force pour réexécuter l'assistant complet (reconfigurer les préférences)

Cela garantit que vous bénéficiez des dernières fonctionnalités et configurations d'agents sans le coût en tokens de la répétition de la configuration complète.