---
title: "Signaler à Kilobat qu’un agent attend ou a terminé · Recettes Kilobat"
url: "https://kilobat.app/fr/guides/recipes/connect-agent-hooks.html"
description: "Reliez les hooks de Claude Code, Codex, Gemini CLI ou Cline à kilobat agent-event, pour que Kilobat sache quand une exécution est en cours, attend votre action ou est terminée."
---

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 CLI · Vé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](https://kilobat.app/fr/docs.html#agents). Un agent peut ensuite appeler ces outils. Les outils qui modifient des réglages indiquent à l’agent de vous demander d’abord.

| Outil et arguments | Ce 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

- [Documentation Kilobat : Connecter des agents](https://kilobat.app/fr/docs.html#connect-agents)
- [llms.txt de Kilobat : référence de la CLI et du MCP](https://kilobat.app/llms.txt)

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.

## Guides associés

- [Faire tourner un agent écran rabattu](https://kilobat.app/fr/guides/recipes/agent-lid-closed.html): Rabattre l’écran met un Mac portable en veille.
- [Garder votre Mac éveillé jusqu’à la fin d’un téléchargement](https://kilobat.app/fr/guides/recipes/keep-mac-awake-download.html): Kilobat garde le Mac éveillé tant que des transferts sont en cours.
- [Vérifier le réseau avant un gros téléchargement dans un agent](https://kilobat.app/fr/guides/recipes/check-network-before-download.html): Un agent peut demander à Kilobat si c’est le bon moment pour un gros transfert.