---
title: "エージェントの待機や完了をKilobatに知らせる · Kilobatレシピ"
url: "https://kilobat.app/ja/guides/recipes/connect-agent-hooks.html"
description: "Claude Code、Codex、Gemini CLI、Clineのフックをkilobat agent-eventにつなぐと、実行が作業中か、入力待ちか、完了したかをKilobatが把握できます。"
---

レシピ

# エージェントの待機や完了をKilobatに知らせる

フックがない場合、Kilobatは通信とCPUからしかエージェントを把握できません。フックを使うと、プロジェクト名と、実行が入力待ちになったときや完了したときがKilobatに伝わります。

アプリとCLIで無料 · 確認日：2026年10月29日

## アプリで

1. 「設定」を開き、「スリープ防止とエージェント」を探します。
2. 「AIエージェントの作業中はMacをスリープさせない」をオンにします。
3. ポップオーバーのセッションストリップを確認します。エージェントの実行ごとに、状態付きのチップが表示されます。

## CLIで

1. Claude Codeの場合は、`~/.claude/settings.json`のSessionStart、UserPromptSubmit、Notification、Stop、StopFailure、SessionEndにコマンドフックを追加します。

   ```
   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. フックを手動でテストします。`--verbose`を付けると、何が起きたかが表示されます。

   ```
   kilobat agent-event start --agent claude --verbose
   ```
5. 記録された実行を確認します。

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

## MCPで

`claude mcp add kilobat -- kilobat mcp`でMCPサーバを一度接続します。他のクライアントについては[ドキュメント](https://kilobat.app/ja/docs.html#agents)を参照してください。接続後は、エージェントがこれらのツールを呼び出せます。設定を変更するツールは、先にユーザに確認するようエージェントに伝えます。

| ツールと引数 | 機能 |
|---|---|
| `list_sessions` `{"days": 1}` | `project`、`state`（working、waitingForYou、done、stalled、networkFailed、failed）、使用したデータ量付きの実行一覧。 |

## 知っておきたいこと

- `kilobat agent-event`は何も出力せず、常に終了コード0で終わるので、エージェントの動作を妨げることはありません。
- アプリが起動していないときは、イベントは小さなファイルに保存され、アプリが起動したときに読み込まれます。
- Kilobatが読み取るのは、セッションID、フォルダ、短いステータステキストだけです。プロンプトや応答は読み取りません。
- これらのフックは、既存のフックと統合してください。

## 出典

- [Kilobatドキュメント：エージェントを接続する](https://kilobat.app/ja/docs.html#connect-agents)
- [Kilobat llms.txt：CLIとMCPのリファレンス](https://kilobat.app/llms.txt)

出典は2026年10月29日に確認しました。manページはmacOSに付属のものです。「ターミナル」で`man <name>`を実行すると開けます。

## 関連ガイド

- [蓋を閉じた状態でエージェントを実行し続ける](https://kilobat.app/ja/guides/recipes/agent-lid-closed.html): Macノートブックは蓋を閉じるとスリープします。
- [ダウンロードが終わるまでMacをスリープさせない](https://kilobat.app/ja/guides/recipes/keep-mac-awake-download.html): Kilobatは、転送の実行中はMacをスリープさせません。
- [エージェントで大きなダウンロードの前にネットワークを確認する](https://kilobat.app/ja/guides/recipes/check-network-before-download.html): エージェントは、今が大きな転送に向いたタイミングかどうかをKilobatに確認できます。