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

v0.4.7

We will also start publishing updates here:
Plannotator x account

What's New in v0.4.5..7

Devcontainer & SSH Support

Plannotator now works in devcontainers, Docker, and SSH environments. Two new environment variables give you full control:

export PLANNOTATOR_REMOTE=1    # Skip browser open attempt
export PLANNOTATOR_PORT=9999   # Fixed port for forwarding

When running remotely, the URL is printed to console so you can open it in your local browser with port forwarding.

Thanks to @kvokka for reporting this! (Closes #27)

OpenCode Agent Switching Fix

Fixed a bug where OpenCode wouldn't switch from the plan agent to the build agent after approving a plan. Now works as expected - approve a plan and Claude continues with implementation.

Thanks to @nielpattin for reporting this! (Closes #29)

Responsive Plan Viewer

The plan viewer now uses screen width more effectively with responsive gutters and a wider content area on large screens.

Thanks to @seanGSISG for their first contribution! (PR #32)

Internal: Shared Server Package

Refactored server logic into a shared @plannotator/server package. Both Claude Code and OpenCode plugins now use the same underlying server, ensuring consistent behavior across both tools.

Contributors

• @seanGSISG - First contribution! 🎉 Improved plan viewer responsiveness
• @kvokka - Bug report for devcontainer hang
• @nielpattin - Bug report for OpenCode agent switching

Full Changelog: v0.4.0...v0.4.5

v0.4.6

What's New in v0.4.5

Devcontainer & SSH Support

Plannotator now works in devcontainers, Docker, and SSH environments. Two new environment variables give you full control:

export PLANNOTATOR_REMOTE=1    # Skip browser open attempt
export PLANNOTATOR_PORT=9999   # Fixed port for forwarding

When running remotely, the URL is printed to console so you can open it in your local browser with port forwarding.

Thanks to @kvokka for reporting this! (Closes #27)

OpenCode Agent Switching Fix

Fixed a bug where OpenCode wouldn't switch from the plan agent to the build agent after approving a plan. Now works as expected - approve a plan and Claude continues with implementation.

Thanks to @nielpattin for reporting this! (Closes #29)

Responsive Plan Viewer

The plan viewer now uses screen width more effectively with responsive gutters and a wider content area on large screens.

Thanks to @seanGSISG for their first contribution! (PR #32)

Internal: Shared Server Package

Refactored server logic into a shared @plannotator/server package. Both Claude Code and OpenCode plugins now use the same underlying server, ensuring consistent behavior across both tools.

Contributors

• @seanGSISG - First contribution! 🎉 Improved plan viewer responsiveness
• @kvokka - Bug report for devcontainer hang
• @nielpattin - Bug report for OpenCode agent switching

Full Changelog: v0.4.0...v0.4.5

v0.4.5

What's New in v0.4.5

Devcontainer & SSH Support

Plannotator now works in devcontainers, Docker, and SSH environments. Two new environment variables give you full control:

export PLANNOTATOR_REMOTE=1    # Skip browser open attempt
export PLANNOTATOR_PORT=9999   # Fixed port for forwarding

When running remotely, the URL is printed to console so you can open it in your local browser with port forwarding.

Thanks to @kvokka for reporting this! (Closes #27)

OpenCode Agent Switching Fix

Fixed a bug where OpenCode wouldn't switch from the plan agent to the build agent after approving a plan. Now works as expected - approve a plan and Claude continues with implementation.

Thanks to @nielpattin for reporting this! (Closes #29)

Responsive Plan Viewer

The plan viewer now uses screen width more effectively with responsive gutters and a wider content area on large screens.

Thanks to @seanGSISG for their first contribution! (PR #32)

Internal: Shared Server Package

Refactored server logic into a shared @plannotator/server package. Both Claude Code and OpenCode plugins now use the same underlying server, ensuring consistent behavior across both tools.

Contributors

• @seanGSISG - First contribution! 🎉 Improved plan viewer responsiveness
• @kvokka - Bug report for devcontainer hang
• @nielpattin - Bug report for OpenCode agent switching

Full Changelog: v0.4.0...v0.4.5

v0.4.3

What's New in v0.4.3

Responsive Plan Viewer (Laptop Fix)

Fixed the plan viewer width for laptop screens. The wider layout from v0.4.2 was too wide on smaller screens. Now properly responsive:

• Laptops: Original comfortable width (max-w-3xl)
• External monitors (1280px+): Wider layout (max-w-5xl)
• Large desktops (1536px+): Full wide layout (max-w-6xl)

---

Includes all features from v0.4.2:

Devcontainer & SSH Support

Plannotator now works in devcontainers, Docker, and SSH environments. Two new environment variables give you full control:

export PLANNOTATOR_REMOTE=1    # Skip browser open attempt
export PLANNOTATOR_PORT=9999   # Fixed port for forwarding

When running remotely, the URL is printed to console so you can open it in your local browser with port forwarding.

Thanks to @kvokka for reporting this! (Closes #27)

OpenCode Agent Switching Fix

Fixed a bug where OpenCode wouldn't switch from the plan agent to the build agent after approving a plan. Now works as expected - approve a plan and Claude continues with implementation.

Thanks to @nielpattin for reporting this! (Closes #29)

Responsive Plan Viewer

The plan viewer now uses screen width more effectively with responsive gutters and a wider content area on large screens.

Thanks to @seanGSISG for their first contribution! (PR #32)

Internal: Shared Server Package

Refactored server logic into a shared @plannotator/server package. Both Claude Code and OpenCode plugins now use the same underlying server, ensuring consistent behavior across both tools.

Contributors

• @seanGSISG - First contribution! 🎉 Improved plan viewer responsiveness
• @kvokka - Bug report for devcontainer hang
• @nielpattin - Bug report for OpenCode agent switching

Full Changelog: v0.4.0...v0.4.3

v0.4.2

What's New in v0.4.2

Devcontainer & SSH Support

Plannotator now works in devcontainers, Docker, and SSH environments. Two new environment variables give you full control:

export PLANNOTATOR_REMOTE=1    # Skip browser open attempt
export PLANNOTATOR_PORT=9999   # Fixed port for forwarding

When running remotely, the URL is printed to console so you can open it in your local browser with port forwarding.

Thanks to @kvokka for reporting this! (Closes #27)

OpenCode Agent Switching Fix

Fixed a bug where OpenCode wouldn't switch from the plan agent to the build agent after approving a plan. Now works as expected - approve a plan and Claude continues with implementation.

Thanks to @nielpattin for reporting this! (Closes #29)

Responsive Plan Viewer

The plan viewer now uses screen width more effectively with responsive gutters and a wider content area on large screens.

Thanks to @seanGSISG for their first contribution! (PR #32)

Internal: Shared Server Package

Refactored server logic into a shared @plannotator/server package. Both Claude Code and OpenCode plugins now use the same underlying server, ensuring consistent behavior across both tools.

Contributors

• @seanGSISG - First contribution! 🎉 Improved plan viewer responsiveness
• @kvokka - Bug report for devcontainer hang
• @nielpattin - Bug report for OpenCode agent switching

Full Changelog: v0.4.0...v0.4.2