OthmanAdi/planning-with-files v2.31.0

v2.31.0 - Codex hooks.json integration

on GitHub

What's new

Codex now gets the full hooks integration it was always supposed to have.

The README has listed Codex as Skills + Hooks since the IDE branch launched, but the install guide only told users to copy the skill files. Nobody got hooks.json or the hooks folder. This release fixes that.

What's included

• .codex/hooks.json with all five lifecycle hooks: SessionStart, UserPromptSubmit, PreToolUse, PostToolUse, Stop
• .codex/hooks/ with shell scripts reused from the Cursor integration and thin Python adapters that translate output into Codex's JSON hook protocol
• Rewritten docs/codex.md with a complete install guide covering workspace and personal installation, hooks merging, codex_hooks = true config, verification steps, and troubleshooting
• Regression tests for all five hooks in tests/test_codex_hooks.py

No changes to master, core skill, or any other IDE

This release only touches the ide/codex branch. The core skill and all other IDE integrations are unchanged.

Thanks to @Leon-Algo for the contribution.