No dia a dia
Pull requests
O Deck lê os pull requests dos seus projetos pela conta que já está no GitHub CLI. Dá para revisar, pedir ajustes ao agente e integrar sem abrir o navegador.
Conectar o GitHub
O Deck não pede token nem abre login próprio: ele usa a conta que já está no GitHub CLI do seu computador. Se o gh não estiver instalado, a tela oferece o link para instalar; se estiver, mas sem login, ela abre um terminal já com o comando de entrar.
- Abra a tela de pull requests, na lateral.
- Confirme a conta que aparece e use o botão de conectar.
- Pronto. Nenhum token do GitHub é guardado pelo Deck.
Desconectar no Deck não desconecta o gh. E se você trocar a conta do GitHub CLI, o app percebe e pede para você reconectar a conta atual.
A lista de PRs
A lista sai dos seus projetos que têm remoto no GitHub, e não de uma busca solta na sua conta. Cada linha mostra o estado, o título e o número, o autor, a branch, o resultado dos checks, a data e quanto entrou e saiu de código.
- Filtros por estado, com abertos, integrados e fechados sem merge, e por autor.
- Busca por título, número ou endereço. Colar o endereço de um PR e dar enter abre ele direto.
- Marca de área local quando já existe uma pasta sua para aquele PR, com o estado da sessão que estiver lá.
A tela se atualiza sozinha, e lembra o projeto, o filtro e a busca que você deixou.
A tela do PR
Corrige registros duplicados na ingestão
#17 · ana.lima · fix/ingestao✕ +12 -3
Retry com backoff exponencial
#18 · bruno.c · feat/retry✓ +48 -7
Atualiza dependências do conector
#19 · carla.m · chore/deps✕ +3 -3
Documenta variáveis de ambiente
#20 · ana.lima · docs/env✓ +27 -2
Remove código morto do exportador
#21 · diego.r · chore/exportador◷ +0 -140
Teste de carga com 10 mil registros
#22 · ana.lima · test/carga✓ +96 -0
Corrige registros duplicados na ingestão
● Aberto · ana.lima · #17 · fix/ingestao → main
Selecione o método
Squash and mergeCombinar todos os commits
Merge commitPreservar o histórico de commits
Rebase and mergeReaplicar os commits na base
Contexto
A sincronização repetia registros após uma nova tentativa.
Validação
Teste de integração e preservação das alterações locais.
Conversa (3)
Conferir a repetição após falha de rede.
São duas abas:
- Resumo. A descrição do PR, as áreas locais que existem para ele e a conversa, juntando comentários soltos e revisões, cada uma marcada como aprovou, pediu mudanças ou comentou.
- Código. A árvore de arquivos alterados, com diff unificado ou lado a lado, carregando mais arquivos conforme você desce.
Ao lado, o painel de checks mostra quantos passaram, cada um com o resultado e o link para o detalhe, e logo abaixo o estado da revisão. Se o PR receber commits novos enquanto você lê, o app avisa antes de deixar você agir sobre uma versão velha.
Comentário preso a uma linha do diff ainda não aparece aqui. Para esses, o link de ver a conversa completa no GitHub continua à mão.
Abrir com agente
O botão de abrir com agente monta a sessão com o pedido já escrito. O Deck escolhe entre dois modos pelo estado do PR:
| Modo | Quando | O que acontece |
|---|---|---|
| Revisar | PR de outra pessoa, ou qualquer PR sem mudanças pedidas a você | Cria uma área separada no commit do PR, sem branch, e o agente abre com instrução de só ler. |
| Atender | O PR é seu, está aberto e a revisão pediu mudanças | O agente abre na sua pasta que já está na branch do PR, para trabalhar de verdade. |
Nos dois casos o pedido diz ao agente para tratar o conteúdo do PR como material a avaliar, não como ordem a cumprir, e proíbe publicar qualquer coisa no GitHub sem você pedir. Título, descrição e comentários escritos por terceiros não entram no prompt.
A área de revisão fica no commit do PR e sem branch. Ela serve para ler e rodar, não para editar: um commit feito ali não pertence a lugar nenhum.
As áreas de revisão
Cada área aparece no bloco de worktrees locais do PR, com o estado escrito por extenso: no mesmo commit do PR, com commits que ainda não estão no GitHub, ou preparada em um commit antigo. Se houver sessão viva ali, o estado dela aparece junto, com um atalho para ir até lá.
Remover pede que você encerre as sessões daquela área antes. Se houver trabalho que não está no GitHub, o app avisa e o botão passa a pedir confirmação explícita.
O lugar onde essas pastas nascem é o mesmo configurado para as worktrees, descrito em Tarefas isoladas.
Integrar
O botão de merge aparece em PR aberto e fora de rascunho. O menu tem um campo opcional de mensagem e os três métodos, cada um com a explicação do que faz:
| Método | O que faz |
|---|---|
| Squash and merge | Combina todos os commits em um. |
| Merge commit | Preserva o histórico de commits. |
| Rebase and merge | Reaplica os commits na base. |
Só ficam disponíveis os métodos que aquele repositório permite. Antes de enviar, o Deck confere se você tem permissão de escrita e se o PR continua no mesmo commit que você revisou. A confirmação diz qual branch vai para qual base e por qual método.
Depois do merge, o PR passa a integrado na hora e a lista se recarrega. O Deck não apaga branch, nem local nem remota, e não liga merge automático: o que sobra é decisão sua.