实用技巧

智能体等待或完成时通知 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 服务器。其他客户端参阅文档。之后智能体就可以调用这些工具。会更改设置的工具会提示智能体先征求你的同意。

工具与参数作用
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> 打开。