v0.5.3

📢 Follow @plannotator on X for updates

---

📋 Missed recent releases?

Release	Highlights
v0.4.16	Dark mode contrast improvements
v0.4.15	Custom browser selection, custom agent switching, YAML frontmatter

---

What's New in v0.5.3

🔍 Code Review System (screenshot below)

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

Claude Code:

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

OpenCode: Add to opencode.json:

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

---

What's Changed

• feat: add code review system for git diffs by @backnotprop in #57

Closes #51, Closes #56

Full Changelog: v0.4.16...v0.5.3

v0.5.2

📢 Follow @plannotator on X for updates

---

📋 Missed recent releases?

Release	Highlights
v0.4.16	Dark mode contrast improvements
v0.4.15	Custom browser selection, custom agent switching, YAML frontmatter

---

What's New in v0.5.2

🔍 Code Review System

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

Run /plannotator-review to try it!

Interactive Diff Viewer

• Split or unified view - Toggle between side-by-side and inline diff formats
• Line-level annotations - Select line numbers 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

Claude Code:

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

OpenCode: Add to opencode.json:

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

---

What's Changed

• feat: add code review system for git diffs by @backnotprop in #57

Closes #51, Closes #56

Full Changelog: v0.4.16...v0.5.2

v0.5.1

📢 Follow @plannotator on X for updates

---

📋 Missed recent releases?

Release	Highlights
v0.5.0	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.0

🔍 Code Review System

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

Run /plannotator-review to try it!

Interactive Diff Viewer

• Split or unified view - Toggle between side-by-side and inline diff formats
• Line-level annotations - Select line numbers 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

---

v0.5.1 Fixes

• Show correct origin badge in code review (Claude Code orange, OpenCode gray)
• Always show file tree sidebar when diff options are available

---

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

Claude Code:

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

OpenCode: Add to opencode.json:

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

---

Full Changelog: v0.5.0...v0.5.1

v0.5.0

📢 Follow @plannotator on X for updates

---

📋 Missed recent releases?

Release	Highlights
v0.4.16	Dark mode contrast improvements
v0.4.15	Custom browser selection, custom agent switching, YAML frontmatter

---

What's New in v0.5.0

🔍 Code Review System

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

Run /plannotator-review to try it!

Interactive Diff Viewer

• Split or unified view - Toggle between side-by-side and inline diff formats
• Line-level annotations - Select line numbers 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

Claude Code:

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

OpenCode: Add to opencode.json:

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

---

What's Changed

• feat: add code review system for git diffs by @backnotprop in #57

Closes #51, Closes #56

Full Changelog: v0.4.16...v0.5.0

v0.4.16

📢 Follow @plannotator on X for updates

---

📋 Missed recent releases?

Release	Highlights
v0.4.15	Custom browser selection, custom agent switching, YAML frontmatter
v0.4.11	Configurable plan saving, agent switching settings

Claude Code users: Want "approve with notes"? Upvote these issues:

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

---

What's New in v0.4.16

Dark Mode Contrast Improvements

Significantly improved dark mode readability based on community feedback:

• Better surface separation - Cards and popovers now have more distinct elevation
• Softer text - Foreground reduced from 95% to 90% lightness to reduce glare
• Visible borders - Border contrast increased for clearer UI definition
• Readable muted text - Muted foreground lifted from 65% to 72% lightness
• Annotation highlights - Boosted opacity in dark mode so highlighted text remains readable

New Design Tokens

Added --success and --warning design tokens, replacing hardcoded Tailwind colors for consistent theming across light and dark modes.

---

Thanks

• @greghughespdx - Dark mode contrast improvements (#53)

---

Install

Claude Code:

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

OpenCode: Add to opencode.json:

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

---

What's Changed

• feat: improve dark mode contrast and add success/warning tokens by @backnotprop in #54

Full Changelog: v0.4.15...v0.4.16

What's Changed

• feat: improve dark mode contrast and add success/warning tokens by @backnotprop in #54

Full Changelog: v0.4.15...v0.4.16

v0.4.15

📢 Follow @plannotator on X for updates

---

📋 Missed v0.4.8-v0.4.11?

Release	Highlights
v0.4.11	Configurable plan saving, agent switching settings
v0.4.8-v0.4.10	Plan saving, "Approve with notes" for OpenCode, Claude Code warning dialog

Claude Code users: Want "approve with notes"? Upvote these issues:

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

---

What's New in v0.4.15

Custom Browser Selection

Specify which browser opens your plans via the PLANNOTATOR_BROWSER environment variable:

# macOS - app name or path
export PLANNOTATOR_BROWSER="Google Chrome"

# Linux/Windows - executable path
export PLANNOTATOR_BROWSER="/usr/bin/firefox"

Custom Agent Switching (OpenCode)

OpenCode users with custom agents can now switch to any agent after plan approval:

• Select Custom from the dropdown
• Enter your agent name (e.g., my-custom-agent)
• Auto-switches after approval

YAML Frontmatter Support

Plans with YAML frontmatter now render as a styled metadata card instead of raw text.

Toolbar Copy Button

New copy button in the annotation toolbar for quickly copying selected text or code blocks.

Improved Post-Decision Messaging

Clearer messaging after approving/denying: "You can close this tab and return to [Agent]."

Bug Fixes & Improvements

• Fixed dynamic agent name display in UI (@lqmanh)
• Consolidated duplicate toolbar components for better maintainability
• Copy now preserves line breaks between block elements

---

Thanks

• @PaulRBerg - Custom browser selection (#42), YAML frontmatter (#43)
• @kylerm42 - Custom agent switching (#47)
• @jellydn - Post-decision messaging improvements (#41)
• @lqmanh - Agent name UI fix (#44)

---

Install

Claude Code:

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

OpenCode: Add to opencode.json:

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

---

What's Changed

• Strip YAML frontmatter from markdown before parsing by @backnotprop in #45
• fix: agent name in UI by @lqmanh in #44
• refactor: consolidate annotation toolbars into single component by @backnotprop in #46
• feat: add PLANNOTATOR_BROWSER env var for custom browser selection by @backnotprop in #48
• improve: clarify post-decision messaging by @backnotprop in #49
• feat: support custom agents for agent switching by @backnotprop in #50

New Contributors

• @lqmanh made their first contribution in #44

Full Changelog: v0.4.11...v0.4.15

v0.4.11

📢 Follow @plannotator on X for updates

---

📋 Missed v0.4.8-v0.4.10?

Release	Highlights
v0.4.10	Configurable plan saving, agent switching settings
v0.4.9	Plan saving to ~/.plannotator/plans/, cross-platform support
v0.4.8	"Approve with notes" for OpenCode, Claude Code warning dialog

Claude Code users: Want "approve with notes"? Upvote these issues:

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

---

What's New in v0.4.11

Bug Fix: Version Display

Fixed stale build artifacts causing incorrect version (0.4.9) to display in the UI. The npm package now correctly shows v0.4.11.

Configurable Plan Saving

Control where your plans are saved via the new Settings UI:

• Enable/Disable saving entirely
• Custom path support (e.g., ~/my-plans/ or any directory)
• Supports ~ for home directory expansion

Configurable Agent Switching (OpenCode)

OpenCode users can now configure agent switching behavior after plan approval:

• Build (default) - Switch to build agent after approval
• Disabled - Stay on current agent (useful for oh-my-opencode users)

---

Thanks

• @TheOutdoorProgrammer - Agent switching feature (#37)

---

Install

Claude Code:

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

OpenCode: Add to opencode.json:

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

What's Changed

• Add configurable agent switching for OpenCode by @backnotprop in #40

Full Changelog: v0.4.10...v0.4.11

v0.4.10

📢 Follow @plannotator on X for updates

---

📋 Missed v0.4.8-v0.4.9?

Release	Highlights
v0.4.9	Plan saving to ~/.plannotator/plans/, cross-platform support
v0.4.8	"Approve with notes" for OpenCode, Claude Code warning dialog

Claude Code users: Want "approve with notes"? Upvote these issues:

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

---

What's New in v0.4.10

Configurable Plan Saving

Control where your plans are saved via the new Settings UI:

• Enable/Disable saving entirely
• Custom path support (e.g., ~/my-plans/ or any directory)
• Supports ~ for home directory expansion

Configurable Agent Switching (OpenCode)

OpenCode users can now configure agent switching behavior after plan approval:

• Build (default) - Switch to build agent after approval
• Disabled - Stay on current agent (useful for oh-my-opencode users)

Documentation Updates

• Updated CLAUDE.md with new API endpoints and file structure
• Removed dead code for cleaner codebase

---

Thanks

• @TheOutdoorProgrammer - Agent switching feature (#37)

---

Install

Claude Code:

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

OpenCode: Add to opencode.json:

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

What's Changed

• Add configurable agent switching for OpenCode by @backnotprop in #40

Full Changelog: v0.4.9...v0.4.10

v0.4.9

📢 Follow @plannotator on X for updates

---

📋 Missed v0.4.7-v0.4.8?

Release	Highlights
v0.4.8	"Approve with notes" for OpenCode, Claude Code warning dialog
v0.4.7	Fixed OpenCode agent switching race condition, UI width adjusted

Claude Code users: Want "approve with notes"? Upvote these issues:

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

---

What's New in v0.4.9

Plan Saving

All plans and annotations are now saved to ~/.plannotator/plans/:

~/.plannotator/plans/
  2026-01-07-my-feature.md           # Plan (saved on open)
  2026-01-07-my-feature.diff.md      # Annotations
  2026-01-07-my-feature-approved.md  # Final snapshot with status

Cross-Platform Support

Works on Windows, macOS, and Linux using os.homedir() for path resolution.

OpenCode Path Notification

OpenCode agents now see where the plan was saved in the tool result.

---

Install

Claude Code:

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

OpenCode: Add to opencode.json:

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

What's Changed

• Add plan saving to ~/.plannotator/plans/ by @backnotprop in #35

Full Changelog: v0.4.8...v0.4.9

Full Changelog: v0.4.8...v0.4.9

v0.4.8

📢 Follow @plannotator on X for updates

---

📋 Missed v0.4.7?

Release	Highlights
v0.4.7	Fixed OpenCode agent switching race condition, UI width adjusted to 832px

Claude Code users: Want "approve with notes"? Upvote these issues:

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

---

What's New in v0.4.8

Approve with Notes (OpenCode)

When you add annotations and approve, OpenCode agents now receive your feedback as "implementation notes" - they proceed to build and see your annotations.

Claude Code Warning Dialog

If you try to approve with annotations in Claude Code, you'll now get a warning explaining the limitation.

New ConfirmDialog Component

Refactored dialogs into a reusable component for cleaner code.

---

Thanks

• @Mavial - feature request (#30)
• @gabber235 - confirmation dialog suggestion

---

Install

Claude Code:

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

OpenCode: Add to opencode.json:

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

Full Changelog: v0.1.0...v0.4.8