Grok Bot の見張りルーティンは「定期チェック」より「webhook 起動」がいい
文章目录
コーディングエージェントの見張り役に「1時間ごとの定期チェック」を組むと、確認のたびに「まだ作業中です」を見るためだけにトークンが溶けていきます。
私は常駐の Worker PC 上で t3code を使い、Claude Code・Codex・Cursor を動かしています。各スレッドを見守る Engineering Lead 役が Grok Bot です。最初は定期実行でスレッドを見回らせる形を考えていましたが、エージェントのフック機能から Grok Bot の webhook を叩く構成に切り替えました。イベントが起きたときだけ Grok Bot が起きるため、待ち時間の空振りがなくなります。
Worker PC と t3code を中心にした開発環境の全体像は、前回の記事にまとめています。
課題:定期チェックは「変化なし」の確認にもトークンを使う
Grok Bot に t3code のスレッドを見張らせるとき、素直に組むと「1時間おきに状況を見に行く」定期ルーティンになります。
ただ、エージェントの作業はほとんどの時間「まだ動いている」だけです。定期チェックにすると、何も変わっていない確認にも毎回トークンを使います。
解決策:終わったときだけ webhook で起こす
Grok Bot のルーティンは、スケジュールの代わりに webhook をきっかけに起動できます。監視側から見に行くのをやめ、エージェント側でイベントが起きたときにだけ webhook を叩く形に変えました。
-
定期実行:変化がなくても毎回起きて確認する
-
webhook 起動:イベントが起きたときだけ起きる
エージェントのフックが [grok] スレッドの終了・質問・承認待ちを webhook で送り、Grok Bot のルーティンを起こす
作業が一区切りついたときや質問が出たときだけ Grok Bot が起き、どのスレッドで何が起きたかを見て、PR の状況をまとめたり私に質問を回したりします。
前提として、Grok Bot(Engineering Lead)から t3 のスレッドを立てるときは、タイトルの先頭に [grok] を付けています。自分で t3 を直接開いて立てたスレッドと見分けるためで、通知もこの [grok] スレッドだけに絞ります。
Claude Code の設定
まず Claude Code から繋ぎました。Grok Bot 側で webhook トリガーのルーティンを作ると URL とキーが発行されるので、Worker PC の ~/.config/t3-hook/env に置きます(以下の値はすべてダミーです)。
~/.config/t3-hook/env(ダミー値)
T3_HOOK_URL=https://example.com/webhooks/DUMMY-ROUTINE-ID T3_HOOK_KEY=DUMMY_KEY_xxxxxxxxxxxxxxxx
~/.claude/settings.json の hooks には4種類を登録し、どれも同じスクリプトをイベント名つきで呼びます。
{
"hooks": {
"Stop": [
{ "hooks": [{ "type": "command", "command": "/.config/t3-hook/t3-hook.sh completed", "timeout": 10 }] }
],
"StopFailure": [
{ "hooks": [{ "type": "command", "command": "/.config/t3-hook/t3-hook.sh failed", "timeout": 10 }] }
],
"PreToolUse": [
{
"matcher": "AskUserQuestion",
"hooks": [{ "type": "command", "command": "/.config/t3-hook/t3-hook.sh waiting", "timeout": 10 }]
}
],
"Notification": [
{
"matcher": "permission_prompt|elicitation_dialog",
"hooks": [{ "type": "command", "command": "/.config/t3-hook/t3-hook.sh waiting", "timeout": 10 }]
}
]
}
}
-
Stop:ターン終了
-
StopFailure:失敗で停止
-
PreToolUse(AskUserQuestion):人への質問
-
Notification:承認待ちなどの通知
t3-hook.sh の中身はシンプルで、t3 が渡すスレッド ID からタイトルを引き、[grok] で始まるスレッドだけ POST します。全スレッドを通知するとノイズになるので、ここで絞っています。エージェントを待たせないよう、POST はバックグラウンドで投げてすぐ終了します。要点だけ抜き出すと次の通りです(簡略版)。
#!/bin/sh
~/.config/t3-hook/t3-hook.sh <completed|waiting|failed>(簡略版)
event="${1:-completed}" input=$(cat) # フックの入力 JSON(cwd, session_id など) . "$HOME/.config/t3-hook/env" # T3_HOOK_URL / T3_HOOK_KEY
tid="$T3CODE_THREAD_ID" # t3 が Claude Code に渡すスレッド ID title=$(~/.t3/bin/t3 thread show "$tid" --json | jq -r '.thread.title') case "$title" in "[grok]"*) ;; *) exit 0 ;; esac # [grok] スレッドだけ
( curl -sS -o /dev/null --max-time 8 -X POST \ -H "Authorization: Bearer $T3_HOOK_KEY" \ -H 'Content-Type: application/json' \ -d "{\"threadId\":\"$tid\",\"event\":\"$event\"}" \ "$T3_HOOK_URL" ) >/dev/null 2>&1 & exit 0
Grok Bot には次のような JSON が届き、ルーティンはこの threadId と event を見て動きます。
{ "threadId": "mcp:00000000-0000-0000-0000-000000000000", "event": "completed", "cwd": "/Users/you/.t3/worktrees/...", "hookEvent": "Stop" }
テスト送信で HTTP 200 が返ることを確認して運用に入れました。
Codex の場合:通知は届くが Claude Code との違いがある
同じ仕組みを Codex でも試しました。Codex にも hooks 機能(~/.codex/hooks.json)があり、Stop で完了通知、PermissionRequest で承認待ち通知を送れます。実際につなぐと、t3 経由の Codex スレッドでも正しいスレッドで webhook が届きました(HTTP 200)。
Claude Code との対応は次の通りです。
通知のタイミングClaude Code (/.claude/settings.json)Codex (/.codex/hooks.json)ターン終了StopStop失敗で停止StopFailure相当するフックなし質問・承認待ちPreToolUse(AskUserQuestion) / NotificationPermissionRequest
設定は Claude Code とほぼ同じ形です。今回は完了通知の Stop だけを入れました。
// /.codex/hooks.json
{
"hooks": {
"Stop": [
{ "hooks": [{ "type": "command", "command": "/.config/t3-hook/t3-codex-hook.sh", "timeout": 15 }] }
]
}
}
動くには動いたものの、Claude Code とは細かい違いがありました。
まず、失敗で止まったことを知らせるフック(StopFailure 相当)がありません。
もう一つ厄介なのが t3 のスレッド ID の扱いです。t3 は Codex の全スレッドを1つの app-server で動かすため、フックに t3 のスレッド ID が渡りません。そこで、作業フォルダ(cwd)と t3 の worktree パスを突き合わせてスレッド ID を逆引きしています。
t3-codex-hook.sh の逆引き部分(簡略版)
cwd=$(printf '%s' "$input" | jq -r '.cwd') tid=$(~/.t3/bin/t3 thread list --json | jq -r --arg cwd "$cwd" \ '.[] | select(.providerInstanceId == "codex" and .worktreePath == $cwd) | .threadId' | head -n1)
[grok] スレッドはそれぞれ専用 worktree で動くので取り違えはほぼ起きませんが、リポジトリ本体のフォルダで直接動くスレッドはこの方法が使えないため対象外になります。
Cursor の現状と今の運用
t3 の Cursor プロバイダで動かしたスレッドでは、このフックが発火しないことがあり、ここは未解決です。
そのため現在は、スレッドの一番上は Claude Code(claudeAgent)で立て、中で呼ぶサブエージェントやレビュアーのモデルは t3-pstack のモデル設定で振り分けています。一番上を Claude Code にしておけば webhook を確実に受けられますし、中の実作業を他モデルに逃がせるので Claude の利用上限にも当たりにくくなります。
まとめ:見張り系ルーティンはまず webhook を疑う
エージェントを「見張る」系のルーティンは、定期実行にする前に webhook 起動で組めないかを考えるのがおすすめです。
ほとんどの時間「まだ作業中」であるエージェントに対して、イベントが起きたときだけ Grok Bot を起こす形にすれば、待っている時間の無駄なトークン消費をなくせます。
参考リンク
沿着这个主题继续读
从一篇文章,找到相关的教程、经验和阅读路径。




