backnotprop/plannotator v0.8.0

on GitHub

Follow @plannotator on X for updates

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 #134
• fix: honor CLAUDE_CONFIG_DIR in install scripts by @backnotprop in #137
• Add the ability to auto close the tab on approval by @senxd in #128
• feat: add resizable side panels by @flex-yj-kim in #141
• chore: relicense from BSL-1.1 to dual MIT/Apache-2.0 by @backnotprop in #144
• feat: add configurable share URL for self-hosted portals by @backnotprop in #146
• feat: named image references and annotate command by @backnotprop in #147
• feat: close annotation toolbar on ESC key press by @flex-yj-kim in #149
• feat: migrate marketing site to Astro with docs and blog by @backnotprop in #150

New Contributors

• @j-token made their first contribution in #134
• @senxd made their first contribution in #128
• @flex-yj-kim made their first contribution in #141

Full Changelog: v0.7.0...v0.8.0