Autenticação

A Veloz CLI autentica via navegador (Device Authorization Flow) — você não precisa copiar tokens manualmente.

Login

veloz login

O que acontece:

1. A CLI gera um código de verificação
2. Abre seu navegador na página de confirmação
3. Você confirma o código (precisa estar logado em app.onveloz.com)
4. A CLI recebe o token e salva em ~/.veloz/config.json

A partir daí, todos os comandos da CLI usam essa sessão.

Verificar quem está autenticado

veloz whoami

Mostra o nome, email e workspace ativo.

Logout

veloz logout

Remove a sessão local. Não revoga nada no servidor — para isso, vá no dashboard em Configurações → Sessões → Encerrar todas.

API keys (CI/automação)

Para GitHub Actions, GitLab CI ou qualquer pipeline não-interativo, use uma API key:

veloz apikey create --name "github-actions"

A chave é exibida uma única vez — guarde-a com segurança.

Use em CI:

VELOZ_API_KEY=veloz_xxx veloz deploy -y

Ou explicitamente:

veloz login --api-key veloz_xxx
veloz deploy -y

A flag -y (auto-confirm) é importante em CI — sem ela, a CLI pode pausar esperando confirmação.

Listar e revogar API keys

veloz apikey list
veloz apikey delete <keyId>

Pelo dashboard: Configurações → API keys.

Múltiplos workspaces

Se você pertence a vários workspaces (orgs), defina o default:

veloz orgs list
veloz orgs use <slug>

Em CI, fixe o workspace via env:

VELOZ_ORG=<slug> veloz deploy -y

Próximos passos

• Primeiro deploy — colocar um app no ar
• CI/CD — workflows do GitHub Actions
• MCP — usar a sessão local com agentes IA