Agentes

Quais agentes

Além deles, qualquer coisa que rode no terminal funciona dentro do Deck, na opção Terminal. O que os três acima ganham a mais é a integração de estado: o app sabe quando eles pedem permissão, quando o turno termina e quanto de contexto já foi usado.

Como o Deck encontra

Ao abrir, o app pergunta ao seu shell de login qual é o caminho de busca dele e usa esse caminho para procurar os agentes. É por isso que funciona mesmo quando o Deck é aberto pelo Dock ou pelo menu Iniciar, onde o ambiente nasce vazio.

Um agente só conta como instalado se responder ao comando de versão. Instalador quebrado ou atalho vazio não passa por instalado, de propósito.

Agente padrão

Em Configurações, nas sessões, você escolhe qual agente vem pré-selecionado na nova sessão e no atalho ⌘⇧C. Só aparecem os instalados. Se o seu favorito sumir da máquina, o app cai no primeiro que encontrar em vez de travar a criação da sessão.

Trocar no meio da conversa

Dá para trocar o agente de uma sessão sem perder o que já foi conversado. O Deck encerra o agente atual, converte o histórico para o formato do destino, com uma nota de passagem, e abre o novo no mesmo terminal retomando aquela conversa.

O app recusa a troca, com o motivo escrito, quando:

• o terminal está rodando outro programa;
• a sessão ainda não tem conversa, porque não houve nenhum pedido;
• a sessão está conectada a outra, já que conexões entre sessões valem apenas para o Claude Code;
• o agente de destino não está instalado.

Plan mode e permissões

No diálogo de nova sessão, Plan mode abre o agente em modo de planejar, onde ele propõe e não edita. A opção fica indisponível para agente que não tem esse modo.

Existem também as opções de dispensar as confirmações, e elas ficam nas configurações do agente, marcadas como perigo:

• Claude Code. Abrir sessões novas pulando a permissão por ferramenta. Não se aplica a sessões em modo de planejar.
• Codex. Política de aprovação e nível de sandbox, escolhidos por você, ou a opção de ignorar os dois de uma vez.

Todas vêm desligadas. Elas existem para ambiente descartável, onde o prejuízo de um comando errado é zero. O que a aprovação significa no dia a dia está em Agentes em paralelo.

Os sinais que o Deck recebe

Para saber o que acontece dentro de cada sessão sem ficar adivinhando pelo texto do terminal, o Deck registra ganchos na configuração de cada agente, no primeiro uso. Cada um no lugar dele:

É daí que saem os estados, a linha de status e os avisos do sistema. Três cuidados que o app toma:

• Guarda uma cópia do arquivo como ele estava antes, uma vez, ao lado do original.
• Não sobrescreve linha de status de terceiro. Se você já tinha a sua, ela é preservada, e o custo e o contexto deixam de aparecer no rodapé.
• Não toca em arquivo que não consegue ler. Se a configuração estiver inválida, o Deck avisa em vez de gravar por cima.

Os ganchos conversam com o app por um endereço local com senha, criado a cada execução. Com o Deck fechado, os eventos ficam anotados em fila e entram no próximo boot, em vez de se perderem.

Desfazer a integração

Em Configurações, no diagnóstico, o bloco de ganchos dos agentes tem dois botões: reinstalar e remover. Remover tira as entradas do Deck dos três agentes de uma vez e avisa exatamente quais arquivos vai tocar.

A remoção desfaz o que o Deck acrescentou, e não restaura a cópia de segurança. Ela continua no disco, ao lado do arquivo original, se você quiser voltar à mão. Sem os ganchos o app segue funcionando, mas o estado das sessões passa a ser deduzido do que o terminal mostra.