v0.3.0 – Codex native hooks
Highlights
- Reworked Codex CLI integration from JSONL session polling to native
~/.codex/hooks.jsoncommand hooks. - Added Codex state sync for session, prompt, tool-use, stop, and compact events.
- Added an opt-in experimental Codex Permission Review toggle for single-use Allow / Deny permission bubbles.
- Added Codex terminal focus metadata from the hook process tree, including real Codex agent PID tracking.
Improvements
- Codex hook installation is idempotent and preserves user hooks.
- Codex permission hooks are off by default; enabling/disabling the experiment only touches
PermissionRequest. - Permission requests fail open when Clawd is unavailable, DND is enabled, bubbles are hidden, or the request is undecided.
- Hardened Codex permission delivery against stale runtime ports by probing candidates before long
/permissionPOSTs. - CI now runs the full hook-side test suite.
Migration notes
- The old Codex JSONL monitor and remote monitor scripts were removed.
- Codex may require running
/hooksinside Codex once to review/trust newly registered command hooks. - If Codex hooks are disabled in Codex config, state sync will remain inactive until hooks are enabled there.
Validation
swift testcd hooks && node test/index.js
Full Changelog: v0.2.4...v0.3.0