stream-json 出力にフックのライフサイクルイベントを含めたい

コマンド / 機能

--include-hook-events

フックイベントを stream-json に含める

概要

--include-hook-events フラグを付けると、--output-format stream-json の出力にフックの発火・完了などのライフサイクルイベントが含まれるようになります。外部システムでフックの実行状況を監視・デバッグしたい場合に使います。

設定例

# stream-json 出力にフックイベントを含めて実行
claude -p "コードをレビューして" \
  --output-format stream-json \
  --include-hook-events

# 出力例（フックイベント部分）
# {"type":"hook_event","hook":"PreToolUse","matcher":"Bash","status":"started"}
# {"type":"hook_event","hook":"PreToolUse","matcher":"Bash","status":"completed","exitCode":0}
# {"type":"hook_event","hook":"PostToolUse","matcher":"Write","status":"completed","exitCode":0}

# jq でフックイベントだけ抽出
claude -p "..." --output-format stream-json --include-hook-events \
  | jq 'select(.type == "hook_event")'

公式ドキュメントを見る