Plannotator

📢 Follow @plannotator on X for updates

| Release | Highlights |
|---------|------------|
| v0.5.7 | Agent auto-responds to code review feedback |
| v0.5.6 | Agent switch fix |
| v0.5.5 | Version display fix |
| v0.5.4 | Windows support, win32 platform fix |
| v0.5.3 | Unified install script for all platforms |
| v0.5.2 | Update banner, always open review UI |
| v0.5.1 | Code review UI improvements |
| v0.5.0 | Code Review System |

What's New in v0.6.0

🎉 Claude Code: Full Permission Mode Support

Requires Claude Code 2.1.7+

A long-standing Claude Code bug has been fixed, and new hook capabilities let Plannotator preserve your permission mode:

| What Changed | Before | Now |
|--------------|--------|-----|
| Plan mode exit | Stayed in plan mode after approve | ✅ Exits correctly |
| Permission mode | New in 2.1.7 | ✅ Preserves your preferred mode |

Choose your permission mode when approving plans:

• Auto-accept Edits (default) — Auto-approve file edits, ask for other tools
• Bypass Permissions — Auto-approve all tool calls
• Manual Approval — Approve each tool call individually

First-time users see a setup dialog. Change anytime in Settings.

✏️ Inline Annotation Editing

Thanks to @GregoryInnovo for this contribution!

Click any annotation in the sidebar panel to edit it directly. Changes sync to the viewer in real-time. No more delete-and-recreate for typos.

🔍 Code Review System

Introduced in v0.5.0 — highlighting for new users

A complete code review experience for reviewing git diffs with inline annotations.

Run /plannotator-review to try it!

💡 How to annotate: Click the line numbers in the diff viewer to select lines, then add your feedback.

Features

• Split or unified view — Toggle between side-by-side and inline diff formats
• Line-level annotations — Select line numbers to annotate specific code
• File tree navigation — Browse changed files with j/k keyboard shortcuts
• Diff type selector — Switch between uncommitted changes, last commit, or vs main
• Agent auto-response — Agent automatically addresses your feedback

⚠️ OpenCode Users: Action Required

Bun doesn't run postinstall scripts, so the /plannotator-review command won't be installed automatically. Run this to get it:

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

This installs the slash command and clears cached plugin versions.

Claude Code Users

Good news! A long-standing bug has been fixed:

| Issue | Status |
|-------|--------|
| #15755 — Plan mode exit | ✅ Fixed in 2.1.x |

Make sure you're on Claude Code 2.1.7+ to get permission mode preservation and proper plan mode exit.

Still waiting on: Upvote #16001 to allow feedback when approving plans (currently only works on deny).

Thanks

• @GregoryInnovo — Inline annotation editing (#58)
• @stranger2904 — XDG_CONFIG_HOME support (#72)
• @maliktafheem — Windows PowerShell 5.1 fix (#65)
• @ovitrif — Original report on plan mode exit (#55)

Install

macOS / Linux:

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

Windows:

irm https://plannotator.ai/install.ps1 | iex

OpenCode: Also add to opencode.json:

{
  "plugin": ["@plannotator/opencode@latest"]
}

💡 OpenCode users: After updating, run the install script above to get the /plannotator-review command.