docs
Começando

Login e Autenticação

Como autenticar na plataforma Veloz via CLI.

A Veloz usa autenticação via navegador (Device Authorization Flow) — sem precisar copiar tokens manualmente.

Login interativo

veloz login

O que acontece:

  1. A CLI gera um código de verificação
  2. Abre o navegador automaticamente na página de autorização
  3. Você confirma o código no navegador
  4. A CLI recebe o token automaticamente
$ veloz login

  ℹ Abrindo navegador para autenticação...

  Código de verificação: ABCD-1234

  Se o navegador não abrir, acesse manualmente:
  https://app.onveloz.com/cli/auth?code=ABCD-1234

  ⠋ Aguardando autorização no navegador...

  ✓ Autenticado com sucesso!
  ℹ Configuração salva em ~/.veloz/config.json

Login com API key (CI/automação)

Para pipelines de CI/CD, use uma API key diretamente:

veloz login --api-key "sua-chave-de-api"

Ideal para GitHub Actions, GitLab CI e outros ambientes automatizados.

Logout

veloz logout

Remove as credenciais salvas em ~/.veloz/config.json.

Verificar autenticação

Se já estiver autenticado e rodar veloz login novamente, a CLI pergunta se deseja fazer login novamente.

Próximos passos