Recette

Signaler à Kilobat qu’un agent attend ou a terminé

Sans hooks, Kilobat ne repère un agent que par son trafic et son usage du processeur. Les hooks lui indiquent le projet, et quand une exécution attend votre action ou est terminée.

Gratuit dans l’app et la CLIVérifié le 29 octobre 2026

Dans l’app

  1. Ouvrez les Réglages et repérez Éveil et agents.

  2. Activez Garder le Mac éveillé pendant le travail des agents IA.

  3. Regardez le bandeau des sessions dans le panneau. Chaque exécution d’agent y apparaît sous forme de pastille, avec son état.

Avec la CLI

  1. Pour Claude Code, ajoutez un hook de commande à ~/.claude/settings.json sous SessionStart, UserPromptSubmit, Notification, Stop, StopFailure et SessionEnd.

    kilobat agent-event --agent claude --stdin-json
  2. Pour Codex, ajoutez cette ligne à ~/.codex/config.toml. Elle signale uniquement la fin.

    notify = ["kilobat", "agent-event", "done", "--agent", "codex", "--json-arg"]
  3. Pour Cline, installez le plug-in Kilobat.

    cline plugin install https://kilobat.app/agents/cline/kilobat.ts
  4. Testez un hook à la main. --verbose indique ce qui s’est passé.

    kilobat agent-event start --agent claude --verbose
  5. Consultez les exécutions enregistrées.

    kilobat sessions --days 1

Via MCP

Connectez une fois le serveur MCP avec claude mcp add kilobat -- kilobat mcp. Pour les autres clients, voir la documentation. Un agent peut ensuite appeler ces outils. Les outils qui modifient des réglages indiquent à l’agent de vous demander d’abord.

Outil et argumentsCe qu’il fait
list_sessions
{"days": 1}
Les exécutions avec project, state (working, waitingForYou, done, stalled, networkFailed ou failed) et les données consommées.

Bon à savoir

  • kilobat agent-event n’affiche rien et se termine toujours avec le code 0 : il ne peut donc pas casser l’agent.
  • Si l’app n’est pas ouverte, les événements attendent dans un petit fichier que l’app lit à son ouverture.
  • Kilobat lit les identifiants de session, les dossiers et de courts textes d’état. Il ne lit jamais les prompts ni les réponses.
  • Fusionnez ces hooks avec ceux que vous avez déjà.

Sources

Sources vérifiées le 29 octobre 2026. Les pages man sont celles installées avec macOS ; ouvrez-en une avec man <name> dans Terminal.