Hot-reload hook configuration during a live session
Open 💬 2 comments Opened Apr 13, 2026 by ignatremizov
💡 Likely answer: A maintainer (github-actions[bot], contributor)
responded on this thread — see the highlighted reply below.
What variant of Codex are you using?
CLI / TUI
What feature would you like to see?
Hot-reload hook configuration during a live session, so hook changes made by the agent or the user can take effect without restarting the thread.
More specifically:
- if
~/.codex/hooks.jsonchanges - if repo-local hook configuration changes
- if supported hook-providing plugin config changes
- Codex should reload the effective hook set for subsequent events in the same live session
This matters because hooks are increasingly part of workflow composition rather than one-time startup config. Today an agent can edit instructions, scripts, and repo state, but cannot reliably update the hook behavior that governs the current session without forcing a restart.
Concrete cases:
- an agent should be able to install or adjust a hook as part of a task and have later events in the same session use it
- a user should be able to iterate on hook behavior without restarting the thread each time
- hook-driven approval/context automation should not require thread restarts to test changes
Any of these would solve it:
- watch hook config files and refresh the effective hook registry automatically
- add a manual reload command such as
/reload-hooks - re-resolve hook config before each lifecycle event if the cost is acceptable
- expose an app-server/CLI control path that allows trusted local automation to request hook reload explicitly
Additional information
Related adjacent issues:
- #14814 Add a native pre-turn dynamic context hook for time-sensitive metadata
- #16430 Plugin docs/examples imply plugin-local hooks, but runtime only executes global hooks.json
- #16466 Hooks should support stable bundle/plugin context for reusable hook scripts
- #16607 Resumed threads keep stale model-visible skills after new skills are added
I did not find an existing issue specifically for hot-reloading hooks or letting an agent manage its own hooks during the current live session.
2 Comments
Potential duplicates detected. Please review them and close your issue if it is a duplicate.
Powered by Codex Action
Indexed this hook ticket in the umbrella tracker: #21753
Goal: collect the scattered Codex hook requests and bugs into one parity matrix for Full Claude Code Hook Parity (29+), while preserving this issue as the detailed thread for its specific behavior.