Início Rápido

Este tour leva cerca de cinco minutos. Ao final você terá um Esquadrão com dois agentes paralelos trabalhando em git worktrees isolados, cada um produzindo um diff que você pode revisar e mesclar.

1. Abra o Vupt e adicione um projeto

Inicie o Vupt. Clique em Adicionar Projeto e aponte para qualquer repositório git local. O Vupt registra apenas o caminho; nada sai da sua máquina ainda.

2. Configure um provedor (BYOK)

Abra Configurações → Provedores e adicione pelo menos uma chave de provedor:

# Exemplo de entrada em ~/.vupt/config.toml escrita pela UI
[providers.anthropic]
api_key_keychain_ref = "vupt/anthropic"
default_model = "claude-sonnet-4-5"

As chaves ficam armazenadas no cofre do sistema operacional (Keychain no macOS, Credential Vault no Windows, libsecret no Linux). O Vupt nunca lê nem persiste o valor bruto da chave em disco.

3. Crie seu primeiro Esquadrão

Na visão do projeto, clique em Novo Esquadrão. Defina um objetivo (adicionar endpoint /healthz com testes) e adicione duas tarefas:

• Tarefa 1: prompt Adicione o handler de rota em src/api/health.ts, agente claude-code
• Tarefa 2: prompt Adicione o teste de integração para /healthz, agente codex

Clique em Lançar. O Vupt cria um git worktree por tarefa e inicia ambos os agentes em paralelo.

4. Acompanhe o diário

Cada tarefa transmite seu log de agente para o painel de diário. Você pode rolar, buscar ou seguir ao vivo. O Vupt persiste cada entrada no banco SQLite local para você reproduzir mais tarde.

5. Revise e mescle

Quando ambas as tarefas concluírem, abra o Visualizador de Diff e aprove, descarte ou peça uma rodada adicional por tarefa. Aprovar executa seus hooks de pós-conclusão configurados (lint, test, build) e oferece abrir um Pull Request.

É isso — você executou um Esquadrão. A seguir, leia Configuração para ajustar padrões ou pule para Conceitos → Esquadrões para o modelo mental.