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 CLIRevisado: 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. Así, un agente puede llamar a estas herramientas. Las herramientas que cambian ajustes indican al agente que te pregunte antes.

Herramienta y argumentosQué 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

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.