Hook Scope
Scope choices
Global / personal
~/.codex/hooks.json~/.codex/hooks/~/.codex/config.toml
Project / repo
<repo>/.codex/hooks.json<repo>/.codex/hooks/<repo>/.codex/config.toml
Hook events
SessionStartUserPromptSubmitPreToolUsePostToolUseStop
Useful defaults
PreToolUse: block or rewrite before executionPostToolUse: log, format, or validate after executionUserPromptSubmit: inject instructions or reject bad promptsSessionStart: seed session contextStop: final checks or continuation prompts