---
title: "Avisar a Kilobat cuando un agente espera o termina · Recetas de Kilobat"
url: "https://kilobat.app/es/guides/recipes/connect-agent-hooks.html"
description: "Conecta los hooks de Claude Code, Codex, Gemini CLI o Cline a kilobat agent-event para que Kilobat sepa cuándo una ejecución está trabajando, te espera o ha terminado."
---

Receta

# Avisar a Kilobat cuando un agente espera o termina

Sin hooks, Kilobat solo ve un agente por su tráfico y su uso de CPU. Los hooks le dicen el proyecto y cuándo una ejecución te espera o ha terminado.

Gratis en la app y en la CLI · Revisado: 29 de octubre de 2026

## En la app

1. Abre Ajustes y busca Activo y agentes.
2. Activa «Mantener el Mac activo mientras trabajan los agentes de IA».
3. Mira la franja de sesiones en la ventana emergente. Cada ejecución de un agente aparece como una etiqueta con su estado.

## Con la CLI

1. Para Claude Code, añade un hook de comando a `~/.claude/settings.json` en SessionStart, UserPromptSubmit, Notification, Stop, StopFailure y SessionEnd.

   ```
   kilobat agent-event --agent claude --stdin-json
   ```
2. Para Codex, añade esta línea a `~/.codex/config.toml`. Solo avisa cuando termina.

   ```
   notify = ["kilobat", "agent-event", "done", "--agent", "codex", "--json-arg"]
   ```
3. Para Cline, instala el plugin de Kilobat.

   ```
   cline plugin install https://kilobat.app/agents/cline/kilobat.ts
   ```
4. Prueba un hook a mano. `--verbose` indica lo que ha pasado.

   ```
   kilobat agent-event start --agent claude --verbose
   ```
5. Consulta las ejecuciones registradas.

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

## Por MCP

Conecta el servidor MCP una vez con `claude mcp add kilobat -- kilobat mcp`. Para otros clientes, consulta [la documentación](https://kilobat.app/es/docs.html#agents). Así, un agente puede llamar a estas herramientas. Las herramientas que cambian ajustes indican al agente que te pregunte antes.

| Herramienta y argumentos | Qué hace |
|---|---|
| `list_sessions` `{"days": 1}` | Ejecuciones con `project`, `state` (working, waitingForYou, done, stalled, networkFailed o failed) y los datos usados. |

## Conviene saber

- `kilobat agent-event` no imprime nada y siempre sale con 0, así que no puede romper el agente.
- Si la app no está abierta, los eventos esperan en un pequeño archivo que la app lee al abrirse.
- Kilobat lee los ID de sesión, las carpetas y un breve texto de estado. Nunca lee las instrucciones ni las respuestas.
- Combina estos hooks con los que ya tengas.

## Fuentes

- [Documentación de Kilobat: Conectar agentes](https://kilobat.app/es/docs.html#connect-agents)
- [llms.txt de Kilobat: referencia de la CLI y MCP](https://kilobat.app/llms.txt)

Fuentes revisadas el 29 de octubre de 2026. Las páginas man son las que se instalan con macOS; abre una con `man <name>` en Terminal.

## Guías relacionadas

- [Mantener un agente en marcha con la tapa cerrada](https://kilobat.app/es/guides/recipes/agent-lid-closed.html): Cerrar la tapa pone en reposo un portátil Mac.
- [Mantener el Mac activo hasta que termine una descarga](https://kilobat.app/es/guides/recipes/keep-mac-awake-download.html): Kilobat mantiene el Mac activo mientras hay transferencias en curso.
- [Comprobar la red antes de una descarga grande en un agente](https://kilobat.app/es/guides/recipes/check-network-before-download.html): Un agente puede preguntar a Kilobat si ahora es buen momento para una transferencia grande.