hooks.md Codex Docs, 2026-04-25 00:42 UTC → 2026-05-01 18:29 UTC

31- `hooks.json`31- `hooks.json`

32- inline `[hooks]` tables inside `config.toml`32- inline `[hooks]` tables inside `config.toml`

33 33 

34Installed plugins can also bundle lifecycle config through their plugin

35manifest or a default `hooks/hooks.json` file. See [Build

36plugins](https://developers.openai.com/codex/plugins/build#bundled-mcp-servers-and-lifecycle-config) for the

37plugin packaging rules.

38 

34In practice, the four most useful locations are:39In practice, the four most useful locations are:

35 40 

36- `~/.codex/hooks.json`41- `~/.codex/hooks.json`