hooks / session-start-context · 約 6 分

SessionStart の additionalContext

startup や resume で追加の developer context を渡します。

学習目標

SessionStart の matcher は source で、値は startup、resume、clear、compact です。 ^{[codex-hooks]}

{
  "hookSpecificOutput": {
    "hookEventName": "SessionStart",
    "additionalContext": "hello-codex-school: 変更後は npm test を実行する。"
  }
}

プレーンテキストの stdout も extra developer context になります。JSON の additionalContext も同じ用途です。

前提

hooks.json の SessionStart がこのスクリプトを指していること。

なぜ必要か

セッションごとに短い作業合意を、AGENTS.md を増やさずに足せます。

実行場所

Web実習 (browser) は WebContainer の Node で公式仕様の入力例を流す練習です。Codex 本体の hook 実行ではありません。local-bridge では compact 後の source: compact でも、公式は次のモデル要求の前にこの hook を走らせます。

echo '{"hook_event_name":"SessionStart","source":"startup"}' | node .codex/hooks/session_start.mjs

成功結果

スクリプトが additionalContext と SessionStart を返します。

失敗対処

matcher を startup|resume にしていると compact では走りません。必要なら matcher を広げます。 ^{[codex-hooks]}