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 CLIVerificado: 29 de outubro de 2026

No app

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

Com a CLI

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
```
Para Codex, adicione esta linha a ~/.codex/config.toml. Ela informa apenas a conclusão.
```
notify = ["kilobat", "agent-event", "done", "--agent", "codex", "--json-arg"]
```

Para Cline, instale o plugin do Kilobat.

cline plugin install https://kilobat.app/agents/cline/kilobat.ts

Teste um hook manualmente. --verbose informa o que aconteceu.
```
kilobat agent-event start --agent claude --verbose
```
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. 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

Verificado em 29 de outubro de 2026.