Plannotator

📢 Follow @plannotator on X for updates

⚠️ 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.

| Release | Highlights |
|---------|------------|
| v0.5.3 | Code Review System |
| v0.4.16 | Dark mode contrast improvements |
| v0.4.15 | Custom browser selection, custom agent switching, YAML frontmatter |

What's New in v0.5.4

Windows Support

Windows users can now install with PowerShell:

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

Unified Install Script

The install script now works for both Claude Code and OpenCode users:

• Installs the plannotator binary
• Installs /plannotator-review slash command for both platforms
• Clears OpenCode plugin cache

What's New in v0.5.3

🔍 Code Review System

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.

Interactive Diff Viewer

• Split or unified view - Toggle between side-by-side and inline diff formats
• Line-level annotations - Select line numbers to annotate and add feedback directly on the code
• File tree navigation - Browse changed files with j/k keyboard shortcuts

Diff Type Selector

Switch between different diff views without leaving the UI:

• Uncommitted changes - All work not yet committed (default)
• Last commit - Review your most recent commit
• vs main - Compare your branch against the default branch

Smart Branch Detection

Automatically detects your default branch (main, master, or custom) - no configuration needed.

Milestone Update Banner

Major releases now show an expanded update notification with feature highlights, making it easier to discover what's new.

UX Improvements

• Streamlined feedback flow with single-step comment input
• Empty state handling when no changes to display
• Line range display normalized for bottom-to-top selections

Claude Code Users

Good news! Code review with "approve with notes" now works for Claude Code users. The /plannotator-review command uses slash commands, which fully support sending feedback back to the agent.

Plan review still has the "approve with notes" limitation due to how PermissionRequest hooks work. Upvote these issues to help:

| Issue | Description |
|-------|-------------|
| #16001 | Allow updated input on ExitPlanMode approve |
| #15755 | PermissionRequest allow doesn't exit plan mode |

Thanks

• @RunJerryDev - Code review feature request (#51)
• @inakiabt - UX feedback on button labeling (#56)
• pyrons_ (X) - Original code review feature request
• spoon (Discord) - OpenCode support for custom slash commands

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"]
}

What's Changed

• feat: add Windows install script by @backnotprop
• feat: unified install script for Claude Code and OpenCode slash commands

Full Changelog: https://github.com/backnotprop/plannotator/compare/v0.5.3...v0.5.4