Plannotator

📢 Follow @plannotator on X for updates

| 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 https://github.com/backnotprop/plannotator/pull/45
• fix: agent name in UI by @lqmanh in https://github.com/backnotprop/plannotator/pull/44
• refactor: consolidate annotation toolbars into single component by @backnotprop in https://github.com/backnotprop/plannotator/pull/46
• feat: add PLANNOTATOR_BROWSER env var for custom browser selection by @backnotprop in https://github.com/backnotprop/plannotator/pull/48
• improve: clarify post-decision messaging by @backnotprop in https://github.com/backnotprop/plannotator/pull/49
• feat: support custom agents for agent switching by @backnotprop in https://github.com/backnotprop/plannotator/pull/50

New Contributors

• @lqmanh made their first contribution in https://github.com/backnotprop/plannotator/pull/44

Full Changelog: https://github.com/backnotprop/plannotator/compare/v0.4.11...v0.4.15