---
title: "Kilobat melden, wenn ein Agent wartet oder fertig ist · Kilobat-Rezepte"
url: "https://kilobat.app/de/guides/recipes/connect-agent-hooks.html"
description: "Verbinde die Hooks von Claude Code, Codex, Gemini CLI oder Cline mit kilobat agent-event, damit Kilobat weiß, wann ein Lauf arbeitet, auf dich wartet oder fertig ist."
---

Rezept

# Kilobat mitteilen, wenn ein Agent wartet oder fertig ist

Ohne Hooks erkennt Kilobat einen Agent nur an seinem Datenverkehr und seiner CPU-Last. Hooks verraten das Projekt und wann ein Lauf auf dich wartet oder fertig ist.

Kostenlos in der App und der CLI · Geprüft: 29. Oktober 2026

## In der App

1. Öffne die Einstellungen und such „Wach & Agenten“.
2. Schalte „Mac wach halten, während KI-Agents arbeiten“ ein.
3. Sieh dir die Statusleiste im Popover an. Jeder Agent-Lauf erscheint als Chip mit seinem Status.

## Mit der CLI

1. Für Claude Code fügst du in `~/.claude/settings.json` unter SessionStart, UserPromptSubmit, Notification, Stop, StopFailure und SessionEnd einen Befehls-Hook hinzu.

   ```
   kilobat agent-event --agent claude --stdin-json
   ```
2. Für Codex fügst du diese Zeile zu `~/.codex/config.toml` hinzu. Sie meldet nur „fertig“.

   ```
   notify = ["kilobat", "agent-event", "done", "--agent", "codex", "--json-arg"]
   ```
3. Für Cline installierst du das Kilobat-Plug-in.

   ```
   cline plugin install https://kilobat.app/agents/cline/kilobat.ts
   ```
4. Teste einen Hook von Hand. Mit `--verbose` erfährst du, was passiert ist.

   ```
   kilobat agent-event start --agent claude --verbose
   ```
5. Lies die aufgezeichneten Läufe.

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

## Über MCP

Verbinde den MCP-Server einmal mit `claude mcp add kilobat -- kilobat mcp`. Für andere Clients siehe [die Dokumentation](https://kilobat.app/de/docs.html#agents). Dann kann ein Agent diese Tools aufrufen. Tools, die Einstellungen ändern, weisen den Agent an, dich vorher zu fragen.

| Tool und Argumente | Was es tut |
|---|---|
| `list_sessions` `{"days": 1}` | Läufe mit `project`, `state` (working, waitingForYou, done, stalled, networkFailed oder failed) und dem Datenverbrauch. |

## Gut zu wissen

- `kilobat agent-event` gibt nichts aus und endet immer mit 0, kann den Agent also nicht stören.
- Läuft die App nicht, warten die Ereignisse in einer kleinen Datei, die die App beim Öffnen liest.
- Kilobat liest Sitzungs-IDs, Ordner und kurze Statustexte. Prompts und Antworten liest es nie.
- Führe diese Hooks mit den Hooks zusammen, die du schon hast.

## Quellen

- [Kilobat-Dokumentation: Agents verbinden](https://kilobat.app/de/docs.html#connect-agents)
- [Kilobat llms.txt: CLI- und MCP-Referenz](https://kilobat.app/llms.txt)

Quellen geprüft am 29. Oktober 2026. Die Manpages sind die mit macOS installierten; öffne eine mit `man <name>` im Terminal.

## Verwandte Anleitungen

- [Einen KI-Agenten bei geschlossenem Deckel laufen lassen](https://kilobat.app/de/guides/recipes/agent-lid-closed.html): Wenn du den Deckel schließt, wechselt ein Mac-Laptop in den Ruhezustand.
- [Mac wach halten, bis ein Download fertig ist](https://kilobat.app/de/guides/recipes/keep-mac-awake-download.html): Kilobat hält den Mac wach, solange Übertragungen laufen.
- [Netzwerk vor einem großen Download in einem Agenten prüfen](https://kilobat.app/de/guides/recipes/check-network-before-download.html): Ein Agent kann Kilobat fragen, ob gerade ein guter Zeitpunkt für eine große Übertragung ist.