omc-setup

Configuración de OMC

Este es el único comando que necesitas aprender. Después de ejecutarlo, todo lo demás es automático.

Cuando se invoque esta habilidad, ejecuta inmediatamente el flujo de trabajo que se indica a continuación. No te limites a repetir o resumir estas instrucciones al usuario.

Nota: Todas las rutas ~/.claude/... en esta guía respetan CLAUDE_CONFIG_DIR cuando esa variable de entorno está definida.

Uso recomendado

Elige este flujo de configuración cuando el usuario quiera instalar, refrescar o reparar el propio OMC.

• Los usuarios de instalación por marketplace/plugin deben llegar aquí después de /plugin install oh-my-claudecode.
• Los usuarios de npm deben llegar aquí después de npm i -g oh-my-claude-sisyphus@latest.
• Los usuarios de desarrollo local y worktrees deben llegar aquí después de actualizar el repositorio clonado y volver a ejecutar la configuración.

Análisis de banderas

Comprueba las banderas en la invocación del usuario:

• --help → Muestra el texto de ayuda (abajo) y detente.
• --local → Solo Fase 1 (destino=local), luego detente.
• --global → Solo Fase 1 (destino=global), luego detente.
• --force → Omite la comprobación previa a la configuración, ejecuta la configuración completa (Fase 1 → 2 → 3 → 4).
• Sin banderas → Ejecuta la comprobación previa a la configuración y luego la configuración completa si es necesario.

Texto de ayuda

Cuando el usuario ejecute con --help, muestra esto y detente:

OMC Setup - Configurar oh-my-claudecode

USO:
  /oh-my-claudecode:omc-setup           Ejecutar el asistente de configuración inicial (o actualizar si ya está configurado)
  /oh-my-claudecode:omc-setup --local   Configurar el proyecto local (.claude/CLAUDE.md)
  /oh-my-claudecode:omc-setup --global  Configurar los ajustes globales (~/.claude/CLAUDE.md)
  /oh-my-claudecode:omc-setup --force   Forzar el asistente completo aunque ya esté configurado
  /oh-my-claudecode:omc-setup --help    Mostrar esta ayuda

MODOS:
  Configuración inicial (sin banderas)
    - Asistente interactivo para la primera configuración
    - Configura CLAUDE.md (local o global)
    - Configura la línea de estado HUD
    - Verifica si hay actualizaciones
    - Limpia valores de configuración obsoletos (5.0.0 eliminó defaultExecutionMode) y apunta el registro MCP a la configuración nativa de Claude Code
    - Configura valores predeterminados del modo equipo (número de agentes, tipo, modelo)
    - Si ya está configurado, ofrece una opción de actualización rápida

  Configuración local (--local)
    - Invoca el coordinador local del plugin mediante `scripts/setup-claude-md.sh`; el shell valida la respuesta del coordinador y su código de salida antes de cualquier trabajo posterior a la instalación
    - Informa solo de las copias de seguridad idénticas byte a byte creadas por el coordinador para los archivos que requirieron modificación
    - Ajustes específicos del proyecto
    - Úsalo para actualizar la configuración del proyecto después de actualizaciones de OMC

  Configuración global (--global)
    - Invoca el coordinador local del plugin mediante `scripts/setup-claude-md.sh`; el shell valida la respuesta del coordinador y su código de salida antes de cualquier trabajo posterior a la instalación
    - Informa solo de las copias de seguridad idénticas byte a byte creadas por el coordinador para los archivos globales modificados
    - Valor predeterminado: sobrescribe explícitamente ~/.claude/CLAUDE.md para que el simple `claude` también use OMC
    - El modo opcional de preservación mantiene el `CLAUDE.md` base del usuario e instala OMC en `CLAUDE-omc.md` para los lanzamientos con `omc`
    - Se aplica a todas las sesiones de Claude Code
    - Conserva los archivos hook heredados del mismo nombre a menos que su contenido histórico exacto esté verificado de forma independiente
    - Úsalo para actualizar la configuración global después de actualizaciones de OMC

  Configuración forzada completa (--force)
    - Omite la comprobación de "ya configurado"
    - Ejecuta el asistente completo desde cero
    - Úsalo cuando quieras reconfigurar las preferencias

EJEMPLOS:
  /oh-my-claudecode:omc-setup           # Primera configuración (o actualizar CLAUDE.md si ya está configurado)
  /oh-my-claudecode:omc-setup --local   # Actualizar este proyecto
  /oh-my-claudecode:omc-setup --global  # Actualizar todos los proyectos
  /oh-my-claudecode:omc-setup --force   # Volver a ejecutar el asistente completo

Para más información: https://github.com/Yeachan-Heo/oh-my-claudecode

Invocación de la configuración

No escanees de forma independiente los directorios de caché de plugins ni selecciones una raíz de plugin en esta habilidad. Invoca el script de configuración desde la raíz del plugin proporcionada por el entorno del plugin en ejecución:

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

El script es el único resolvedor de caché. Solo acepta raíces de plugin completas (docs/CLAUDE.md canónico, artefacto coordinador y la habilidad wiki), elige una versión de caché estricta de SemVer completo, verifica el handshake del código fuente compilado y falla de forma cerrada en caso de desacuerdo en el protocolo o estado del coordinador. No descargues configuración ni modifiques CLAUDE.md fuera de ese coordinador.

Comprobación previa a la configuración: ¿Ya está configurado?

CRÍTICO: Antes de hacer nada más, comprueba si la configuración ya se ha completado. Esto evita que los usuarios tengan que volver a ejecutar el asistente completo después de cada actualización.

# Comprobar si la configuración ya se completó
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 "ERROR: jq es necesario para inspeccionar el estado de configuración existente de OMC. La configuración existente no se modificó."
    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 "ERROR: La configuración existente de OMC no es un JSON válido. La configuración existente no se modificó."
    exit 1
  fi

  if [ -n "$SETUP_COMPLETED" ] && [ "$SETUP_COMPLETED" != "null" ]; then
    echo "La configuración de OMC ya se completó el: $SETUP_COMPLETED"
    [ -n "$SETUP_VERSION" ] && echo "Versión de configuración: $SETUP_VERSION"
    ALREADY_CONFIGURED="true"
  fi
fi

Si ya está configurado (y no hay bandera --force)

Si ALREADY_CONFIGURED es verdadero Y el usuario NO pasó las banderas --force, --local o --global:

Usa AskUserQuestion para preguntar:

Pregunta: "OMC ya está configurado. ¿Qué te gustaría hacer?"

Opciones:

1. Actualizar CLAUDE.md y limpiar valores de configuración obsoletos - Instala el CLAUDE.md canónico del plugin activo y ejecuta el Paso 2.4 de la Fase 2 sin volver a ejecutar la configuración completa.
2. Ejecutar la configuración completa de nuevo - Pasar por el asistente completo.
3. Cancelar - Salir sin cambios.

Si el usuario elige "Actualizar CLAUDE.md y limpiar valores de configuración obsoletos":

• Detecta si existe la configuración local (.claude/CLAUDE.md) o global (~/.claude/CLAUDE.md).
• Si existe la local, ejecuta: bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" local
• Si solo existe la global, ejecuta: bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" global
• Ejecuta el Paso 2.4 de la Fase 2 para limpiar la clave obsoleta defaultExecutionMode.
• Omite todos los demás pasos después de la limpieza.
• Informa del éxito y sal.

Si el usuario elige "Ejecutar la configuración completa de nuevo":

• Continúa con la detección de reanudación a continuación.

Si el usuario elige "Cancelar":

• Sal sin ningún cambio.

Anulación de la bandera de forzado

Si el usuario pasa la bandera --force, omite esta comprobación y procede directamente a la configuración.

Detección de reanudación

Antes de comenzar cualquier fase, comprueba si hay estado existente:

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

Si existe estado (la salida no es "fresh"), usa AskUserQuestion para preguntar:

Pregunta: "Se encontró una sesión de configuración anterior. ¿Te gustaría reanudarla o empezar de nuevo?"

Opciones:

1. Reanudar desde el paso $LAST_STEP - Continuar donde lo dejaste.
2. Empezar de nuevo - Comenzar desde el principio (borra el estado guardado).

Si el usuario elige "Empezar de nuevo":

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

Ejecución de fases

Para las banderas --local o --global:

Lee el archivo en ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/01-install-claude-md.md y sigue sus instrucciones. (El archivo de fase maneja la salida temprana para el modo de bandera).

Para la configuración completa (predeterminada o --force):

Ejecuta las fases secuencialmente. Para cada fase, lee el archivo correspondiente y sigue sus instrucciones:

1. Fase 1 - Instalar CLAUDE.md: Lee ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/01-install-claude-md.md y sigue sus instrucciones.

2. Fase 2 - Configuración del entorno: Lee ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/02-configure.md y sigue sus instrucciones. La Fase 2 debe delegar la configuración de HUD/statusLine a la habilidad hud; no generes ni parchees rutas de statusLine directamente aquí.

3. Fase 3 - Configuración de integraciones: Lee ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/03-integrations.md y sigue sus instrucciones.

4. Fase 4 - Finalización: Lee ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/04-welcome.md y sigue sus instrucciones.

Manejo elegante de interrupciones

IMPORTANTE: Este proceso de configuración guarda el progreso después de cada fase mediante ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh. Si se interrumpe (Ctrl+C o pérdida de conexión), la configuración puede reanudarse desde donde se quedó.

Mantenerse actualizado

Después de instalar actualizaciones de oh-my-claudecode (vía npm o actualización de plugin):

Automático: Simplemente ejecuta /oh-my-claudecode:omc-setup - detectará que ya configuraste y ofrecerá una opción rápida de "Actualizar CLAUDE.md y limpiar valores de configuración obsoletos" que omite el resto del asistente.

La ruta de actualización rápida debe seguir ejecutando el Paso 2.4 de la Fase 2 para que las actualizaciones eliminen el valor obsoleto de defaultExecutionMode; no debe escribir ningún valor de modo de ejecución de reemplazo.

Opciones manuales:

• /oh-my-claudecode:omc-setup --local para actualizar solo la configuración del proyecto.
• /oh-my-claudecode:omc-setup --global para actualizar solo la configuración global.
• /oh-my-claudecode:omc-setup --force para volver a ejecutar el asistente completo (reconfigurar preferencias).

Esto asegura que tengas las funciones y configuraciones de agente más recientes sin el coste de tokens de repetir la configuración completa.