> ## 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 Claude Code

> Install Plannotator for Claude Code, review plans at ExitPlanMode, and invoke document and code review skills.

Claude Code can pause `ExitPlanMode` for a Plannotator review. Approval lets Claude continue. Sending feedback denies the request with your annotations so Claude can revise the plan.

## Install

Install the command:

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

Then run these commands in Claude Code:

```text theme={null}
/plugin marketplace add backnotprop/plannotator
/plugin install plannotator@plannotator
```

Restart Claude Code so the hook takes effect. The standard installer also adds the `plannotator-review`, `plannotator-annotate`, and `plannotator-last` skills under `~/.claude/skills`.

## Use it

Enter plan mode and ask Claude Code to prepare a plan. When Claude calls `ExitPlanMode`, Plannotator opens the plan. **Approve** allows implementation. **Send Feedback** returns your annotations and direct edits to Claude for another revision.

Use the installed skills for manual workflows:

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

`/plannotator-review` accepts a GitHub pull request or GitLab merge request URL. `/plannotator-annotate` accepts a file, folder, or web URL.

## Manual hook setup

If you do not use Claude Code's plugin system, add this hook to `~/.claude/settings.json`:

```json theme={null}
{
  "hooks": {
    "PermissionRequest": [
      {
        "matcher": "ExitPlanMode",
        "hooks": [
          {
            "type": "command",
            "command": "plannotator",
            "timeout": 345600
          }
        ]
      }
    ]
  }
}
```

Last verified against Plannotator OSS v0.23.1 on July 18, 2026. Maintained by the Plannotator project.