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 CLIGeprü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. Dann kann ein Agent diese Tools aufrufen. Tools, die Einstellungen ändern, weisen den Agent an, dich vorher zu fragen.

Tool und ArgumenteWas 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

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