---
title: "Informar ao Kilobat quando um agente aguarda ou termina · Receitas do Kilobat"
url: "https://kilobat.app/pt/guides/recipes/connect-agent-hooks"
description: "Conecte hooks do Claude Code, Codex, Gemini CLI ou Cline ao kilobat agent-event para que o Kilobat saiba quando uma execução trabalha, aguarda você ou terminou."
---

Receita

# Avise ao Kilobat quando um agente estiver aguardando ou tiver terminado

Sem hooks, o Kilobat detecta um agente apenas pelo tráfego e pela CPU. Hooks informam o projeto e quando uma execução aguarda você ou terminou.

Grátis no app e na CLI · Verificado: 29 de outubro de 2026

## No app

1. Abra Ajustes e encontre Atividade e agentes.
2. Ative Manter o Mac ativo enquanto agentes de IA trabalham.
3. Confira a faixa de sessões na janela popover. Cada execução de agente aparece como um indicador com seu estado.

## Com a CLI

1. Para Claude Code, adicione um hook de comando a `~/.claude/settings.json` em SessionStart, UserPromptSubmit, Notification, Stop, StopFailure e SessionEnd.

   ```
   kilobat agent-event --agent claude --stdin-json
   ```
2. Para Codex, adicione esta linha a `~/.codex/config.toml`. Ela informa apenas a conclusão.

   ```
   notify = ["kilobat", "agent-event", "done", "--agent", "codex", "--json-arg"]
   ```
3. Para Cline, instale o plugin do Kilobat.

   ```
   cline plugin install https://kilobat.app/agents/cline/kilobat.ts
   ```
4. Teste um hook manualmente. `--verbose` informa o que aconteceu.

   ```
   kilobat agent-event start --agent claude --verbose
   ```
5. Leia as execuções registradas.

   ```
   kilobat sessions --days 1
   ```

## Pelo MCP

Conecte o servidor MCP uma vez com `claude mcp add kilobat -- kilobat mcp`. Para outros clientes, consulte [a documentação](https://kilobat.app/pt/docs/agents#agents). Depois, um agente pode chamar essas ferramentas. Ferramentas que alteram ajustes orientam o agente a pedir sua confirmação primeiro.

| Ferramenta e argumentos | O que faz |
|---|---|
| `list_sessions` `{"days": 1}` | Execuções com `project`, `state` (working, waitingForYou, done, stalled, networkFailed ou failed) e os dados usados. |

## É bom saber

- `kilobat agent-event` não imprime nada e sempre termina com 0, para não interromper o agente.
- Se o app não estiver em execução, os eventos aguardam em um pequeno arquivo que o app lê ao abrir.
- O Kilobat lê IDs de sessão, pastas e textos curtos de estado. Ele nunca lê prompts ou respostas.
- Mescle esses hooks com os hooks que você já tem.

## Fontes

- [Documentação do Kilobat: conectar agentes](https://kilobat.app/pt/docs/agents#connect-agents)
- [Kilobat llms.txt: referência de CLI e MCP](https://kilobat.app/llms.txt)

Verificado em 29 de outubro de 2026.

## Guias relacionados

- [Mantenha um agente em execução com a tampa fechada](https://kilobat.app/pt/guides/recipes/agent-lid-closed): Fechar a tampa coloca um notebook Mac em repouso.
- [Mantenha o Mac ativo até um download terminar](https://kilobat.app/pt/guides/recipes/keep-mac-awake-download): O Kilobat mantém o Mac ativo durante as transferências.
- [Verifique a rede antes de um grande download em um agente](https://kilobat.app/pt/guides/recipes/check-network-before-download): Um agente pode perguntar ao Kilobat se é um bom momento para uma grande transferência.