Skip to content

v0.3.0 – Codex native hooks

Latest

Choose a tag to compare

@github-actions github-actions released this 10 May 09:50
af16e4f

v0.3.0 – Codex native hooks

Highlights

  • Reworked Codex CLI integration from JSONL session polling to native ~/.codex/hooks.json command 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 /permission POSTs.
  • 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 /hooks inside 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 test
  • cd hooks && node test/index.js

Full Changelog: v0.2.4...v0.3.0