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.
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.
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.