Agentes em paralelo

O Grid

O Grid, em ⌘⇧M, mostra vários terminais ao vivo, lado a lado. Não são miniaturas nem capturas: cada painel é a sessão de verdade, e você pode digitar em qualquer um deles.

No topo ficam as abas: uma por projeto com sessão viva, mais a aba Todos. Cada aba guarda o próprio arranjo e mostra, em um resumo, quantas sessões estão esperando, quantas concluíram e quantas seguem trabalhando.

Para encher o Grid rápido, use Adicionar todas. Para limpar, Esvaziar. Uma sessão também entra e sai pelo canto do card dela na lateral, e tirar do Grid não encerra nada: a sessão continua viva.

Arrumar o Grid

• Tamanho da grade. O seletor no topo define colunas por linhas, passando o mouse sobre a matriz. O teto é quatro por quatro, ou seja, dezesseis painéis.
• Trocar de lugar. Arraste um painel sobre outro para trocar, ou solte em uma célula vazia para fixar a posição.
• Ocupar mais espaço. A alça no canto do painel estica ele por mais células, e um balão mostra o tamanho enquanto você arrasta.
• Redimensionar. Os divisores entre colunas e linhas se arrastam.
• Maximizar. Pelo botão do painel, por duplo clique no cabeçalho ou com ⌘⇧Enter.
• Grupos de arranjo. Salve o arranjo atual como um grupo e alterne entre eles com ⌥Q e ⌥W.
• Agrupar por projeto. Uma grade por projeto, empilhadas, quando você mistura repositórios.
• Escurecer as outras. As sessões fora do foco perdem brilho, na intensidade que você escolher.

O cabeçalho de cada painel é configurável: dá para mostrar ou esconder projeto, nome, branch, marca de worktree, porcentagem de contexto e estado. Para andar entre os painéis sem o mouse, use ⌘ com as setas.

Os estados de uma sessão

Esses estados vêm de sinais do próprio agente, e não de adivinhação: quando ele avisa que pediu permissão, que terminou o turno ou que começou a usar uma ferramenta, o Deck reage na hora. Sem esses sinais, o app se vira com o que o terminal mostra, o que funciona bem para um shell comum.

Como o Deck chama você

O aviso do sistema é econômico de propósito. Ele só dispara quando três coisas são verdade ao mesmo tempo: o sinal veio do próprio agente, o estado é pedindo permissão ou turno concluído, e a janela do Deck não está em foco. Se você já está olhando para o app, ele não interrompe.

• No macOS. Notificação com som, contagem no ícone do Dock e o número no ícone da barra de menu.
• No Windows. Notificação do sistema, bolinha com a contagem sobre o ícone na barra de tarefas e a janela piscando até você olhar.
• No ícone da bandeja. O menu lista cada sessão com o agente, a pasta e o que ela quer.

Clicar na notificação não só abre o app: ele foca exatamente a sessão que chamou. Tudo isso se configura em Configurações, incluindo silenciar por um tempo, escolher o som e ligar um alerta visual em vez do sonoro.

Responder sem entrar no terminal

Quando o agente pede permissão, os botões Permitir e Negar aparecem no rodapé da sessão. Eles falam direto com o agente, e não digitam nada no terminal.

Com muitas sessões abertas, ⌘⇧O abre a lista de quem está esperando você, de todos os projetos de uma vez, com os mesmos botões. Cada linha mostra a ferramenta em uso, quantos subagentes estão no ar, o progresso das tarefas, o contexto consumido, o custo e há quanto tempo o turno começa. Clicar salta para a sessão.

Como um aviso some

Turno concluído some sozinho quando você realmente viu: a janela do Deck precisa estar em foco e aquele terminal, à vista. Não contam como visto a janela em segundo plano, um modal por cima e o computador sem ninguém na frente.

Pedido de permissão é a exceção: ele nunca some por ter sido visto. Só sai quando você decide entre permitir e negar.

O rodapé da sessão

Na barra de baixo de cada painel cabe quase tudo que importa sobre aquela sessão:

• O modelo em uso e um botão para copiar a última resposta do agente.
• A porcentagem de contexto consumido, com barra, amarela a partir de 70 por cento e vermelha a partir de 90.
• O custo estimado daquela sessão.
• A ferramenta que o agente está usando neste segundo, ou o rótulo do estado.
• O relógio do turno, contando desde o último pedido seu.
• O atalho do painel, para você saber qual número focar.

Custo e limite de uso

O rodapé geral do app soma o custo estimado de todas as sessões e mostra o limite de uso da sua conta do agente nas janelas de cinco horas e de sete dias, sempre pela pior das duas. Ele fica amarelo a partir de 70 por cento, vermelho a partir de 90, e diz a que horas a janela reseta.

A tela de uso e custo abre pela palheta de comandos e agrega por dia e por modelo, a partir do histórico que está no seu computador.

O quadro de trabalho

Quando as sessões passam de uma dúzia, o Grid deixa de caber na tela e o quadro de Trabalho vira o melhor lugar. Ele coloca cada sessão em uma de quatro colunas, pelo que ela precisa agora, e escreve o motivo no card.

As colunas são calculadas, então não há o que arrastar. A busca do quadro procura por sessão, branch, pull request e tarefa ao mesmo tempo, e dá para filtrar por projeto e por agente.

Existe ainda o mapa de agentes, em ⌘⇧A, que mostra as sessões e os subagentes que cada uma despachou. O passo seguinte, que é isolar cada tarefa para elas não se atropelarem, está em Tarefas isoladas.