Skip to main content
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 directory already exists, the installer enables hooks and writes the Plannotator Stop hook. Restart Codex Desktop after installation. The installer respects $CODEX_HOME, falling back to ~/.codex. It installs the shared plannotator-review, plannotator-annotate, and plannotator-last skills under ~/.agents/skills.
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.

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.23.1 on July 18, 2026. Maintained by the Plannotator project.
Last modified on July 19, 2026