Começar
Sua primeira sessão
O caminho mais curto até ver o Deck funcionando: um projeto, uma sessão, um pedido e o diff do lado.
Adicione o projeto
Projeto, no Deck, é uma pasta do seu computador, normalmente um repositório git. Adicione o primeiro apontando para a pasta do repositório em que você já trabalha. Ele aparece na lateral e passa a ser o lugar onde as sessões nascem.
Comece por um repositório que você conhece bem e que esteja com o trabalho salvo. A primeira sessão é para entender o fluxo, não para testar o agente em algo delicado.
Crie a sessão
- Com o projeto selecionado, abra uma nova sessão.
- Escolha o agente na lista. Aparecem os que estão instalados e logados no seu computador.
- Escreva o primeiro pedido, ou deixe em branco e converse depois, direto no terminal.
- Confirme. A sessão abre já rodando o agente, com o terminal pronto.
~/ingestao ❯ git log --oneline -3
4a093ce Testes da sincronização
4edff57 Evita registros duplicados na sincronização
3b1d01c Fila com limite configurável
~/ingestao ❯ npm test --silent
Nova sessão
✓ Criar sessão isolada (worktree)
Parte de main. Arquivos e stage separados das outras tarefas.
Plan mode (só planeja, não edita)
Em segundo plano (sem roubar o foco)
As opções do diálogo
| Opção | O que faz |
|---|---|
| Primeiro prompt | O que o agente recebe assim que abrir. É opcional. |
| Sessão isolada | Cria uma worktree: pasta e branch próprias, com arquivos e área de stage separados das outras tarefas. |
| Plan mode | O agente só planeja e não edita. Bom para entender o que ele pretende antes de deixar mexer. |
| Em segundo plano | A sessão nasce sem roubar o foco, para você continuar no que estava fazendo. |
Na primeira vez, marque Sessão isolada. É o que garante que o agente trabalhe em uma branch própria, sem misturar com o que você tem aberto. O funcionamento está em Tarefas isoladas.
Acompanhe
A partir daqui você não precisa ficar olhando. A sessão muda de estado sozinha e avisa quando precisa de você:
- Trabalhando. O agente está no turno dele.
- Pedindo permissão. Ele quer usar uma ferramenta e espera a sua resposta. O sistema notifica.
- Turno concluído. Acabou o que estava fazendo e o resultado está lá para você ver.
Com mais de uma sessão aberta, o Grid mostra todas ao mesmo tempo. É o assunto de Agentes em paralelo.
Revise
Quando o agente terminar, abra o diff. Ele mostra o que mudou na branch da sessão, arquivo por arquivo, ao lado do terminal. Dá para ajustar ali mesmo no editor embutido e continuar a conversa sem trocar de janela.
~/ingestao ❯ git log --oneline -3
4a093ce Testes da sincronização
4edff57 Evita registros duplicados na sincronização
3b1d01c Fila com limite configurável
~/ingestao ❯ npm test --silent
✔ salva cada registro uma vez (2.3ms)
✔ ignora repetidos ao repetir (0.4ms)
✔ informa recebidos e salvos (0.5ms)
ℹ tests 3 · pass 3 · fail 0
~/ingestao ❯
@@ -1,7 +1,14 @@
-// Sincronização da ingestão.
+// Sincronização da ingestão com proteção contra duplicatas.
export async function sincronizar(registros, salvar) {
- for (const registro of registros) {
+ const encontrados = new Set();
+ const novos = registros.filter(registro => {
+ if (encontrados.has(registro.id)) return false;
+ encontrados.add(registro.id);
+ return true;
+ });
+ for (const registro of novos) {
await salvar(registro);
}
- return { recebidos: registros.length, salvos: registros.length };
+ return { recebidos: registros.length, salvos: novos.length };
Contra a base 2
src/sincronizar.js+10 -3
test/sincronizar.test.js+21
Gostou do resultado? O caminho até o merge está em Pull requests. Não gostou? Peça o ajuste no mesmo terminal, ou descarte a worktree e comece de novo.
Depois da primeira
Quando a primeira sessão fizer sentido, estes são os próximos passos naturais:
- Projetos, sessões e painéis, para organizar antes de abrir muita coisa.
- Agentes em paralelo, que é o motivo de o Deck existir.
- Atalhos, porque o app foi feito para ser usado pelo teclado.