Trabalhando com agentes de IA

O PATerminal funciona com qualquer agente de CLI e tem suporte extra para o Claude Code (claude) e o Codex (codex): ele sabe qual painel está rodando qual agente, em qual conversa ele está e se precisa de você.

Escrito para o PATerminal v1.8.3

Detecção de agentes

Inicie o claude ou o codex em qualquer painel como você faria normalmente. O PATerminal percebe o processo, rotula o painel e o vincula à conversa salva do agente. Não há nada para configurar nem comando intermediário.

Executando, aguardando e concluído

Cada sessão mostra Executando, Aguardando entrada ou Concluído na barra lateral, mesmo fora da tela. A detecção roda de forma nativa e ignora o ruído que os agentes produzem quando você apenas olha para eles — alternar sessões, mudar o foco e redesenhar o terminal não contam como trabalho.

  • Uma sessão passa para Executando quando você digita nela ou quando ela continua gerando saída por alguns segundos.
  • Ela passa para Concluído quando esse trabalho para. Se você não estava olhando, ela ganha um ponto de atenção e entra no filtro Não vistas.
  • Aguardando entrada significa que o agente está pedindo uma aprovação ou uma resposta.

Notificações no desktop

Quando uma sessão que você não está vendo termina ou começa a esperar por você, o PATerminal envia uma notificação no desktop — “Concluído” ou “Aguardando entrada” com o nome da sessão. Sessões que você está vendo nunca notificam. Desative as notificações em Configurações → Notificações.

Dica

No macOS, se nenhuma notificação aparecer, permita as notificações do PATerminal em Ajustes do Sistema → Notificações.

As conversas sobrevivem a reinicializações

Feche o PATerminal com agentes rodando e, no próximo início, cada um reabre com a conversa salva (claude --resume <id> / codex resume <id>). Se não for possível determinar o ID, o PATerminal usa a conversa mais recente da pasta (claude --continue / codex resume --last).

Se um agente encerrar sozinho, um aviso oferece Retomar conversa: clique para digitar o comando exato de retomada e pressionar Enter por você, ou clique em Fechar para dispensar.

Observação para quem usa o Codex

O Codex 0.154.0 anima pontinhos na área de entrada mesmo quando está ocioso, o que deixaria a sessão em Executando para sempre. O PATerminal desativa esses efeitos decorativos nas sessões do Codex que ele inicia e, ao abrir, salva whimsy = false em [tui] no ~/.codex/config.toml (ou $CODEX_HOME/config.toml), para que o codex digitado à mão também se comporte. As outras configurações e os comentários do arquivo são preservados, e os indicadores de trabalho continuam ativos.

Observação

Essa configuração no nível do usuário também vale para o Codex fora do PATerminal. Reinicie as sessões do Codex que já estavam rodando para aplicá-la.

Indo além

  • Histórico — reabra qualquer conversa anterior em uma nova sessão e revise todos os prompts que você enviou.
  • Modo par — deixe dois agentes implementarem e revisarem juntos.
  • Transmissão de entrada e Frases rápidas — envie a mesma instrução para vários agentes.
  • Worktrees — dê a cada agente o próprio checkout para que eles não editem os mesmos arquivos.

Ainda com dúvidas?

Confira as perguntas frequentes ou mande um e-mail com seu sistema operacional, a versão do PATerminal e o que você já tentou. Respondemos a todas as mensagens.