Codex plan review uses the experimental Stop hook. Plannotator reads the latest plan after the turn renders. Feedback asks Codex to continue the same turn and revise the plan.
Install
On macOS, Linux, or WSL, run:
When Codex is installed or its home already contains user configuration, the installer enables hooks and writes the Plannotator Stop hook. Restart Codex Desktop after installation.
The installer stores hook configuration under $CODEX_HOME. If $CODEX_HOME is not set, it uses ~/.codex. The installer stores the shared plannotator-review, plannotator-annotate, and plannotator-last skills under ~/.agents/skills. $CODEX_HOME does not change that location.
Codex hooks are currently disabled on Windows. The Windows installer does not enable the plan-review hook.
Use it
When a Codex turn ends with a plan, Plannotator opens automatically. Approval leaves the completed turn as-is. Feedback returns a continuation reason so Codex can revise the plan.
Use shell commands for manual workflows:
You can also invoke $plannotator-review, $plannotator-annotate, or $plannotator-last.
See Install and Manage Plannotator Skills for the optional skills, specific-skill installation, updates, and removal.
Update
Rerun the standard installer. It replaces the binary and shared core skills, then updates its managed Codex Stop hook without replacing a custom Plannotator hook wrapper.
Check manual hook configuration
Codex requires the feature flag in ~/.codex/config.toml or a repository’s .codex/config.toml:
The adjacent hooks.json can contain:
Use an absolute command path for Codex Desktop because app-launched processes may not inherit your shell PATH.
Last verified against Plannotator OSS v0.25.1 on July 31, 2026. Maintained by the Plannotator project. 