Plannotator

Follow @plannotator on X for updates

| Release | Highlights |
|---------|------------|
| v0.7.0 | TOC sidebar, sticky actions, save to notes without approving, import teammate reviews, viewed file tracking |
| v0.6.8 | Mermaid diagram rendering, repo/branch info display |
| v0.6.7 | Quick Comment mode, type-to-comment shortcut, smart agent detection |
| v0.6.6 | OpenCode sub-agent fix, CVE-2026-22812 security update |
| v0.6.5 | Cmd+C shortcut, newline preservation, hook timeout fix |
| v0.6.4 | Cmd+Enter keyboard shortcut |
| v0.6.3 | OpenCode npm package fix, cache path fix |
| v0.6.2 | OpenCode title generation fix, WSL browser detection |

What's New in v0.8.0

Plannotator is now fully open source under MIT/Apache-2.0. This release adds a new annotate command for reviewing any markdown file, a self-hosted share portal option, resizable panels, mermaid diagram controls, auto-close on approval, and a full documentation site at plannotator.ai.

Open Source — MIT / Apache-2.0

Plannotator is now dual-licensed under MIT and Apache-2.0, replacing the previous BSL-1.1 license. Use it however you want — no restrictions, no time-delayed open source. (#144)

Annotate Any Markdown File

A new /plannotator-annotate <file.md> slash command opens any markdown file in the annotation UI. Useful for reviewing specs, ADRs, or any document that lives alongside your code. Combined with named image references — attach images to annotations and reference them by name (e.g., "login-mockup") so the agent knows exactly what you're pointing at.

• Thanks to @theflysurfer for requesting the annotate command (#109), with input from @deviantony, @ChrisEdwards, and @arieh
• Thanks to @luketych for requesting named image references (#67)

Self-Hosted Share Portal

Set PLANNOTATOR_SHARE_URL to point share links at your own instance of the share portal instead of share.plannotator.ai. Build the portal with bun run build:portal and deploy it anywhere — S3, Nginx, Vercel, Cloudflare Pages. All data still lives in the URL hash; the portal is a static page.

• Thanks to @ffmmjj for the original feature request (#12)

Resizable Side Panels

The annotation sidebar and TOC panels can now be resized by dragging. Panel widths persist across sessions.

• Thanks to @flex-yj-kim for the contribution (#141)

Mermaid Diagram Controls

Mermaid diagrams now support zoom, pan, and drag — making large or complex diagrams navigable without squinting. Built on the rendering support added in v0.6.8.

• Thanks to @j-token for the contribution (#134)
• Thanks to @poor-defined for reporting the display issue (#125)

Auto-Close Tab on Approval

The browser tab now closes automatically after you approve a plan. One fewer thing to manage when you're deep in a review cycle. Configurable in Settings.

• Thanks to @senxd for the contribution (#128)
• Thanks to @jellydn for the feature request (#41), with input from @ovitrif and @thoroc

Quality of Life

• ESC closes annotation toolbar — dismiss the toolbar without clicking away. Thanks to @flex-yj-kim (#149)
• CLAUDE_CONFIG_DIR honored in install scripts — custom Claude config directories are now respected during installation. Thanks to @daFish for reporting (#136)

Documentation Site

plannotator.ai now has full documentation and a blog. Installation guides for Claude Code, OpenCode, and remote/devcontainer setups. Reference pages for environment variables, keyboard shortcuts, and API endpoints. Guides for sharing, Obsidian integration, and self-hosting. Built with Astro 5 — static HTML, fast, searchable. (#150)

Install / Update

macOS / Linux:

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

Windows:

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

Claude Code Plugin: Run /plugin in Claude Code, find plannotator, and click "Update now".

OpenCode: Clear cache and restart:

rm -rf ~/.bun/install/cache/@plannotator

Then in opencode.json:

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

What's Changed

• feat: add zoom, pan, and drag controls to mermaid diagrams by @j-token in https://github.com/backnotprop/plannotator/pull/134
• fix: honor CLAUDE_CONFIG_DIR in install scripts by @backnotprop in https://github.com/backnotprop/plannotator/pull/137
• Add the ability to auto close the tab on approval by @senxd in https://github.com/backnotprop/plannotator/pull/128
• feat: add resizable side panels by @flex-yj-kim in https://github.com/backnotprop/plannotator/pull/141
• chore: relicense from BSL-1.1 to dual MIT/Apache-2.0 by @backnotprop in https://github.com/backnotprop/plannotator/pull/144
• feat: add configurable share URL for self-hosted portals by @backnotprop in https://github.com/backnotprop/plannotator/pull/146
• feat: named image references and annotate command by @backnotprop in https://github.com/backnotprop/plannotator/pull/147
• feat: close annotation toolbar on ESC key press by @flex-yj-kim in https://github.com/backnotprop/plannotator/pull/149
• feat: migrate marketing site to Astro with docs and blog by @backnotprop in https://github.com/backnotprop/plannotator/pull/150

New Contributors

• @j-token made their first contribution in https://github.com/backnotprop/plannotator/pull/134
• @senxd made their first contribution in https://github.com/backnotprop/plannotator/pull/128
• @flex-yj-kim made their first contribution in https://github.com/backnotprop/plannotator/pull/141

Full Changelog: https://github.com/backnotprop/plannotator/compare/v0.7.0...v0.8.0