omc-setup

Configuração do OMC

Este é o único comando que você precisa aprender. Depois de executá-lo, todo o resto é automático.

Quando esta skill for invocada, execute imediatamente o fluxo de trabalho abaixo. Não apenas reafirme ou resuma estas instruções para o usuário.

Nota: Todos os caminhos ~/.claude/... neste guia respeitam CLAUDE_CONFIG_DIR quando essa variável de ambiente está definida.

Melhor Uso

Escolha este fluxo de configuração quando o usuário quiser instalar, atualizar ou reparar o próprio OMC.

• Usuários de instalação via Marketplace/plugin devem cair aqui depois de /plugin install oh-my-claudecode
• Usuários npm devem cair aqui depois de npm i -g oh-my-claude-sisyphus@latest
• Usuários de desenvolvimento local e worktree devem cair aqui depois de atualizar o repositório clonado e reexecutar a configuração

Análise de Flags

Verifique as flags na invocação do usuário:

• --help → Mostrar Texto de Ajuda (abaixo) e parar
• --local → Fase 1 apenas (alvo=local), depois parar
• --global → Fase 1 apenas (alvo=global), depois parar
• --force → Pular Verificação Pré-Configuração, executar configuração completa (Fase 1 → 2 → 3 → 4)
• Sem flags → Executar Verificação Pré-Configuração, depois configuração completa se necessário

Texto de Ajuda

Quando o usuário executar com --help, exiba isto e pare:

OMC Setup - Configurar oh-my-claudecode

USO:
  /oh-my-claudecode:omc-setup           Executar o wizard de configuração inicial (ou atualizar se já configurado)
  /oh-my-claudecode:omc-setup --local   Configurar projeto local (.claude/CLAUDE.md)
  /oh-my-claudecode:omc-setup --global  Configurar configurações globais (~/.claude/CLAUDE.md)
  /oh-my-claudecode:omc-setup --force   Forçar wizard de configuração completo mesmo se já configurado
  /oh-my-claudecode:omc-setup --help    Mostrar esta ajuda

MODOS:
  Configuração Inicial (sem flags)
    - Wizard interativo para configuração pela primeira vez
    - Configura CLAUDE.md (local ou global)
    - Configura a linha de status do HUD
    - Verifica atualizações
    - Limpa valores de configuração obsoletos (5.0.0 removeu defaultExecutionMode) e aponta o registro MCP para a configuração nativa do Claude Code
    - Configura padrões de modo de equipe (número de agentes, tipo, modelo)
    - Se já configurado, oferece opção de atualização rápida

  Configuração Local (--local)
    - Invoca o coordenador local do plugin através de `scripts/setup-claude-md.sh`; o shell valida a resposta do coordenador e seu status de saída antes de qualquer trabalho pós-instalação
    - Relata backups idênticos byte a byte criados pelo coordenador apenas para arquivos que precisaram de mutação
    - Configurações específicas do projeto
    - Use isto para atualizar a configuração do projeto após atualizações do OMC

  Configuração Global (--global)
    - Invoca o coordenador local do plugin através de `scripts/setup-claude-md.sh`; o shell valida a resposta do coordenador e seu status de saída antes de qualquer trabalho pós-instalação
    - Relata backups idênticos byte a byte criados pelo coordenador apenas para arquivos globais alterados
    - Padrão: sobrescreve explicitamente ~/.claude/CLAUDE.md para que o `claude` simples também use o OMC
    - Modo de preservação opcional mantém o `CLAUDE.md` base do usuário e instala o OMC em `CLAUDE-omc.md` para inicializações `omc`
    - Aplica-se a todas as sessões do Claude Code
    - Preserva arquivos de hook legados com o mesmo nome, a menos que seu conteúdo histórico exato seja verificado de forma independente
    - Use isto para atualizar a configuração global após atualizações do OMC

  Configuração Completa Forçada (--force)
    - Ignora a verificação "já configurado"
    - Executa o wizard de configuração completo do zero
    - Use quando quiser reconfigurar preferências

EXEMPLOS:
  /oh-my-claudecode:omc-setup           # Primeira configuração (ou atualizar CLAUDE.md se configurado)
  /oh-my-claudecode:omc-setup --local   # Atualizar este projeto
  /oh-my-claudecode:omc-setup --global  # Atualizar todos os projetos
  /oh-my-claudecode:omc-setup --force   # Reexecutar wizard de configuração completo

Para mais informações: https://github.com/Yeachan-Heo/oh-my-claudecode

Invocação da Configuração

Não faça varredura independente em diretórios de cache de plugin nem selecione uma raiz de plugin nesta skill. Invoque o script de configuração a partir da raiz do plugin fornecida pelo ambiente de plugin em execução:

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

O script é o único resolvedor de cache. Ele aceita apenas raízes de plugin completas (docs/CLAUDE.md canônico, artefato do coordenador e skill wiki), escolhe uma versão de cache estrita de SemVer completo, verifica o handshake do código-fonte compilado e falha de forma fechada em caso de discordância no protocolo ou status do coordenador. Não baixe configuração nem altere CLAUDE.md fora desse coordenador.

Verificação Pré-Configuração: Já Configurado?

CRÍTICO: Antes de fazer qualquer outra coisa, verifique se a configuração já foi concluída. Isso evita que os usuários tenham que reexecutar o wizard de configuração completo após cada atualização.

# Verificar se a configuração já foi concluída
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 "ERRO: jq é necessário para inspecionar o estado existente da configuração OMC. A configuração existente não foi modificada."
    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 "ERRO: A configuração OMC existente é um JSON inválido. A configuração existente não foi modificada."
    exit 1
  fi

  if [ -n "$SETUP_COMPLETED" ] && [ "$SETUP_COMPLETED" != "null" ]; then
    echo "A configuração OMC foi concluída em: $SETUP_COMPLETED"
    [ -n "$SETUP_VERSION" ] && echo "Versão da configuração: $SETUP_VERSION"
    ALREADY_CONFIGURED="true"
  fi
fi

Se Já Configurado (e sem flag --force)

Se ALREADY_CONFIGURED for verdadeiro E o usuário NÃO passou as flags --force, --local ou --global:

Use AskUserQuestion para perguntar:

Pergunta: "O OMC já está configurado. O que você gostaria de fazer?"

Opções:

1. Atualizar CLAUDE.md e limpar valores de configuração obsoletos - Instalar o CLAUDE.md canônico do plugin ativo e executar a Fase 2, Etapa 2.4 sem reexecutar a configuração completa
2. Executar configuração completa novamente - Passar pelo wizard de configuração completo
3. Cancelar - Sair sem alterações

Se o usuário escolher "Atualizar CLAUDE.md e limpar valores de configuração obsoletos":

• Detectar se a configuração local (.claude/CLAUDE.md) ou global (~/.claude/CLAUDE.md) existe
• Se a local existir, executar: bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" local
• Se apenas a global existir, executar: bash "${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-claude-md.sh" global
• Executar a Fase 2, Etapa 2.4 para limpar a chave obsoleta defaultExecutionMode
• Pular todas as outras etapas após a limpeza
• Relatar sucesso e sair

Se o usuário escolher "Executar configuração completa novamente":

• Continuar com a Detecção de Retomada abaixo

Se o usuário escolher "Cancelar":

• Sair sem alterações

Substituição pela Flag Force

Se o usuário passar a flag --force, pule esta verificação e prossiga diretamente para a configuração.

Detecção de Retomada

Antes de iniciar qualquer fase, verifique o estado existente:

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

Se o estado existir (a saída não for "fresh"), use AskUserQuestion para perguntar:

Pergunta: "Sessão de configuração anterior encontrada. Deseja retomar ou começar do zero?"

Opções:

1. Retomar da etapa $LAST_STEP - Continuar de onde parou
2. Começar do zero - Iniciar do início (limpa o estado salvo)

Se o usuário escolher "Começar do zero":

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

Execução das Fases

Para flags --local ou --global:

Leia o arquivo em ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/01-install-claude-md.md e siga suas instruções. (O arquivo de fase lida com a saída antecipada para o modo de flag.)

Para configuração completa (padrão ou --force):

Execute as fases sequencialmente. Para cada fase, leia o arquivo correspondente e siga suas instruções:

1. Fase 1 - Instalar CLAUDE.md: Leia ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/01-install-claude-md.md e siga suas instruções.

2. Fase 2 - Configuração de Ambiente: Leia ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/02-configure.md e siga suas instruções. A Fase 2 deve delegar a configuração do HUD/statusLine para a skill hud; não gere nem altere caminhos de statusLine inline aqui.

3. Fase 3 - Configuração de Integrações: Leia ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/03-integrations.md e siga suas instruções.

4. Fase 4 - Conclusão: Leia ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/skills/omc-setup/phases/04-welcome.md e siga suas instruções.

Tratamento Gracioso de Interrupções

IMPORTANTE: Este processo de configuração salva o progresso após cada fase via ${OMC_SETUP_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/scripts/setup-progress.sh. Se for interrompido (Ctrl+C ou perda de conexão), a configuração pode retomar de onde parou.

Mantendo-se Atualizado

Após instalar atualizações do oh-my-claudecode (via npm ou atualização de plugin):

Automático: Basta executar /oh-my-claudecode:omc-setup - ele detectará que você já configurou e oferecerá uma opção rápida "Atualizar CLAUDE.md e limpar valores de configuração obsoletos" que pula o restante do wizard.

O caminho de atualização rápida ainda deve executar a Fase 2, Etapa 2.4 para que as atualizações removam o valor obsoleto defaultExecutionMode; ele não deve escrever nenhuma configuração de modo de execução substituta.

Opções manuais:

• /oh-my-claudecode:omc-setup --local para atualizar apenas a configuração do projeto
• /oh-my-claudecode:omc-setup --global para atualizar apenas a configuração global
• /oh-my-claudecode:omc-setup --force para reexecutar o wizard completo (reconfigurar preferências)

Isso garante que você tenha os recursos e configurações de agente mais recentes sem o custo de token de repetir a configuração completa.