實用技巧

AI 代理程式等待或完成時通知 Kilobat

沒有 hook 時，Kilobat 只能從流量和 CPU 看出代理程式在做事。hook 會告訴它是哪個專案，以及執行何時在等你、何時已完成。

App 和 CLI 中免費檢查日期：2026年10月29日

在 App 中

  1. 打開「設定」，找到「喚醒與代理程式」。

  2. 開啟「AI 代理程式工作時保持 Mac 喚醒」。

  3. 看看彈出式視窗裡的工作階段列。每次代理程式執行都會顯示成一個標籤，附上它的狀態。

使用 CLI

  1. Claude Code：在 ~/.claude/settings.json 的 SessionStart、UserPromptSubmit、Notification、Stop、StopFailure 和 SessionEnd 下加入 command hook。

    kilobat agent-event --agent claude --stdin-json

  2. Codex：在 ~/.codex/config.toml 加入這一行。它只會回報完成。

    notify = ["kilobat", "agent-event", "done", "--agent", "codex", "--json-arg"]

  3. Cline：安裝 Kilobat 外掛。

    cline plugin install https://kilobat.app/agents/cline/kilobat.ts

  4. 手動測試 hook。--verbose 會說明發生了什麼。

    kilobat agent-event start --agent claude --verbose

  5. 查看記錄下來的執行。

    kilobat sessions --days 1

透過 MCP

用 claude mcp add kilobat -- kilobat mcp 連接 MCP 伺服器一次即可。其他用戶端請參閱說明文件。之後 AI 代理程式就能呼叫這些工具。會更改設定的工具會告訴 AI 代理程式先詢問你。

工具與參數作用
list_sessions
{"days": 1}
各次執行的 project、state（working、waitingForYou、done、stalled、networkFailed 或 failed）和用量。

注意事項

  • kilobat agent-event 不會輸出任何內容，而且一律以 0 結束，所以不會弄壞代理程式。
  • 如果 App 沒有在執行，事件會先存在一個小檔案裡，App 打開時再讀取。
  • Kilobat 只讀取工作階段 ID、資料夾和簡短的狀態文字，絕不讀取提示詞或回覆。
  • 把這些 hook 和你現有的 hook 合併。

資料來源

資料來源檢查日期：2026年10月29日。man 頁面為 macOS 內建版本；在終端機中用 man <name> 開啟。