# `runner add`

Registra uma nova app no runner. Faz clone shallow do repo, lê .deploy.yml (ou gera via wizard), encripta secrets/ckey/token no state file, e opcionalmente deploya.

# Sintaxe

runner add --repo <USER>/<repo> [flags]

# Flags

# Detecção de duplicate (v2.21.0+)

Desde v2.21.0, runner detecta quando você tenta registrar um repo que já está em uso por outra app:

$ runner add --repo usuario/meu-app --branch main --ckey "..." --instance production
Error: duplicate_repo: Repo usuario/meu-app já está registrado como `meu-app-old`
       (branch: dev, status: registered).

       Opções:
         --force-duplicate            permite criar SEGUNDA app pro mesmo repo
         runner unregister meu-app-old --force    remove a anterior

Quando usar --force-duplicate:

• Testes A/B com versões paralelas do mesmo repo
• Multi-instance experimental (raro)
• Deploys de branches diferentes do mesmo repo como apps separadas

Quando NÃO usar:

• Você esqueceu o nome da app antiga → runner list mostra todas
• Quer trocar a config da app existente → runner unregister + re-add OU runner edit

# Exemplos

# Add básico
runner add --repo usuario/meu-app --branch main --ckey --instance production

# Add com deploy automático
runner add --repo usuario/meu-app --branch main --ckey --instance production --deploy

# Reusa token de app já registrada
runner add --repo usuario/outro-app --branch main --token-from meu-app --ckey

# Multi-instance experimental
runner add --repo usuario/meu-app --branch main-experimental --ckey \
  --instance staging --force-duplicate

# Veja Também

• `runner unregister` — remove app registrada
• `runner tokens` — gerencia tokens GitHub
• `runner edit` — altera branch/instance da app
• `runner list` — lista apps registradas