Notificações quando um agente de programação termina ou pede aprovação

Para ser notificado quando um agente de programação termina ou precisa de aprovação, ative os alertas integrados do agente ou acrescente um hook que corra nesses eventos. Se vai estar longe do computador, envie o alerta para o telemóvel. Teste-o antes de sair, porque um agente à espera de aprovação não faz nada até lhe responder.

Este guia usa o Claude Code nos exemplos. Manter o computador acordado tem um guia próprio. O Mono da Reunified envia estes alertas para os agentes que executa através dele, mas o método funciona com qualquer configuração.

1. Decida que eventos do agente precisam de alerta

Há três eventos que importam:

Se configurar só um alerta, que seja o de permissão.

2. Ative os alertas no Claude Code

O Claude Code envia uma notificação quando termina ou para à espera de permissão e parece que não está ao computador. Por predefinição, só mostra notificações no ambiente de trabalho no Ghostty, no Kitty e no iTerm2 (configuração do terminal). Noutros terminais, defina preferredNotifChannel como "terminal_bell" em ~/.claude/settings.json para fazer soar a campainha. No tmux, acrescente set -g allow-passthrough on a ~/.tmux.conf e volte a carregá-lo.

Para usar um som ou um comando à sua escolha, acrescente hooks ao mesmo ficheiro. O evento Notification aceita filtros (matchers) como permission_prompt (uma aprovação está à espera há cerca de seis segundos) e idle_prompt (o Claude terminou há cerca de um minuto e você não escreveu nada desde então). Num Mac, esta configuração toca um som diferente para cada um:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "permission_prompt",
        "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }]
      },
      {
        "matcher": "idle_prompt",
        "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Hero.aiff" }]
      }
    ]
  }
}

O guia de hooks também tem comandos de notificação no ambiente de trabalho para macOS, Linux e Windows. Os outros agentes funcionam de outra forma, por isso consulte a documentação de cada um.

3. Envie o alerta para o telemóvel

Há três caminhos para chegar ao telemóvel:

• A aplicação do próprio agente. Com o Remote Control do Claude Code ativo, execute /config e ative as notificações push quando o Claude decide («Push when Claude decides»), quando são precisas ações («Push when actions required») ou ambas. É preciso um plano elegível e a aplicação Claude com sessão iniciada na mesma conta, com as notificações permitidas.
• Um hook que envia uma mensagem push, por exemplo com curl para um serviço de push cuja aplicação tem no telemóvel.
• Uma aplicação complementar que retransmite os eventos da sessão a partir do computador.

Todos os caminhos exigem que o computador esteja ligado, acordado e online, com o agente ainda a correr. Guarde qualquer token de um hook em ~/.claude/settings.json e não no .claude/settings.json do projeto, que pode acabar num commit do repositório.

4. Mantenha o texto dos alertas privado no ecrã bloqueado

Qualquer pessoa perto de um telemóvel bloqueado consegue ler as pré-visualizações. Deixe segredos, conteúdo de ficheiros e linhas de registo fora das mensagens dos hooks. Envie só o evento e o nome do projeto: para um projeto fictício chamado «invoice-export», «invoice-export: aprovação necessária» chega. No iPhone, abra Definições > Notificações e defina Mostrar pré-visualizações como Quando desbloqueado. O Android também consegue ocultar conteúdo sensível no ecrã bloqueado, embora o nome da opção varie de telemóvel para telemóvel.

No Mono, um alerta de conclusão mostra a última mensagem do agente, encurtada se for longa. Um alerta de permissão mostra o pedido tal como o agente o descreve, muitas vezes o comando.

5. Teste com uma tarefa inofensiva antes de sair

No computador de casa, inicie uma sessão chamada «verificação invoice-export» e peça ao agente que corra os testes e comunique qualquer falha sem alterar ficheiros. O agente pergunta antes de executar comandos, por isso pede autorização para correr npm test. No computador, abra outro ecrã ou outra aplicação, depois bloqueie o telemóvel e vá para outra divisão.

No Mono, deve ver:

1. Um alerta «Pedido de permissão do agente» com o comando de teste.
2. Ao premir o alerta, abre essa sessão, onde escolhe Permitir. Um pedido posterior envia o seu próprio alerta.
3. «O agente terminou em “verificação invoice-export”» com a última mensagem do agente, como «Um teste em dates.test.ts falha por causa dos fusos horários. Não alterei nenhum ficheiro.»

Depois, corra uma segunda tarefa com a sessão aberta no telemóvel: não chega nenhum alerta enquanto está a ver. Antes de sair, confirme que nenhum dispositivo tem a sessão no ecrã.

6. Resolva alertas que não chegam

No Mono, abra Configurações > Notificações e verifique «Todas as notificações», «Code» (sessões terminadas e paradas), «Solicitações de permissão» e «Enviar para seus outros dispositivos». Estão todas ativadas por predefinição. Os alertas vêm do computador que executa o agente, por isso mantenha o Mono a correr nesse computador.

Antes de aprovar a partir do telemóvel, leia o que verificar num pedido de permissão. Agentes de programação a partir do telemóvel trata do resto da configuração. O Mono ainda não está disponível, mas pode inscrever-se na lista de espera.