Use Plannotator with Claude Code

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:

curl -fsSL https://plannotator.ai/install.sh | bash

Then run these commands in Claude Code:

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

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

{
  "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.

Last modified on July 19, 2026

Agents Codex

⌘I

Start

Plans and documents

Code review

Reference

Agents

Editors and notes

Troubleshooting

Related project

Use Plannotator with Claude Code

Install

Use it

Manual hook setup

​Install

​Use it

​Manual hook setup

Install

Use it

Manual hook setup