> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plannotator.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Plannotator with Codex

> Enable Plannotator's Codex Stop hook, review plans after they render, and invoke review skills or shell commands.

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:

```bash theme={null}
curl -fsSL https://plannotator.ai/install.sh | bash
```

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`.

<Warning>
  Codex hooks are currently disabled on Windows. The Windows installer does not enable the plan-review hook.
</Warning>

## 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:

```text theme={null}
!plannotator review
!plannotator annotate path/to/spec.md
!plannotator last
```

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`:

```toml theme={null}
[features]
hooks = true
```

The adjacent `hooks.json` can contain:

```json theme={null}
{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "/absolute/path/to/plannotator",
            "timeout": 345600
          }
        ]
      }
    ]
  }
}
```

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.