github backnotprop/plannotator v0.11.1

one day ago

Follow @plannotator on X for updates


Missed recent releases?
Release Highlights
v0.11.0 Auto-save annotation drafts, comment popover, Obsidian vault browser, deny message framing fix, configurable OpenCode timeout
v0.10.0 Short URL sharing with E2E encryption, code suggestions in review UI, CJK input method support, customizable Obsidian filenames, XDG install fix
v0.9.3 Linked document navigation & annotation, VS Code diff integration, toolbar dismiss fix, automated npm publishing
v0.9.0 Plan Diff with two view modes, version history, sidebar redesign, terminology cleanup
v0.8.5 Pi coding agent support, auto-close countdown, image endpoint security fix, OpenCode package fix
v0.8.0 Open source (MIT/Apache-2.0), annotate command, self-hosted share portal, resizable panels, mermaid controls, auto-close on approval, documentation site
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

What's New in v0.11.1

Two headline features in this release: a VS Code extension that opens plan reviews inside editor tabs instead of the browser, and Pinpoint mode — a point-and-click alternative to drag-selecting text for annotations. The VS Code extension keeps you in the editor, and Pinpoint mode makes annotating faster when you want to target a whole paragraph, heading, or table cell without precision-dragging across it.

VS Code Extension (coming to Marketplace this week)

The VS Code extension is built and merged into the monorepo, but not yet published to the VS Code Marketplace. Marketplace publishing will be finalized this week — follow @plannotator for the announcement. If you want to try it now, you can build and install locally with bun run build:vscode && bun run package:vscode.

When Claude Code runs in VS Code's integrated terminal, the extension opens plan reviews inside a VS Code tab instead of launching an external browser window. Plan review, code review, and annotate all work in-editor — no more Alt-Tabbing to a browser. The panel auto-closes on approve or deny. If you prefer the browser, disable it via the plannotatorWebview.injectBrowser setting.

This started as a community proposal by @alpgul in #91, and @7tg (Barbaros Goren) built the first working implementation at 7tg/plannotator-vscode. That repo is now archived and the extension lives in the monorepo at apps/vscode-extension/. The initial commit preserves @7tg's authorship.

  • Thanks to @alpgul for the original proposal (#91)
  • Thanks to @7tg for the community implementation

Pinpoint Mode

A new input method that lets you annotate by clicking instead of dragging. Toggle between Select (the existing drag-to-select behavior) and Pinpoint in the toolbar, or hold Alt/Option to temporarily switch modes.

In Pinpoint mode, hovering over the plan highlights the element under your cursor — a paragraph, heading, list item, table cell, bold text, inline code, or an entire code block — with a dashed outline and a label tooltip describing what you're targeting. Click to select it, and the existing annotation flow (markup, comment, or redline) takes over.

The targeting is context-aware. Inside a table, hovering near the outer edge targets the whole table; moving inward targets individual cells. List items are individually targetable, but hovering in the gap between items or the left gutter targets the entire list. Code blocks route through the existing code annotation path with line-level selection.

This is especially useful for longer blocks where drag-selecting the full text is tedious, or for precise targeting of inline elements like a single bold word or link.

Additional Changes

  • Untracked files in code review — newly created files (not yet git add'd) were invisible in the /plannotator-review UI because git diff only covers tracked files. The diff now includes untracked new files so the full picture of the agent's work is visible during review (#227 by @zerone0x, fixes #189 reported by @zhuscat)
  • Hooks.json validation on install — the install scripts now check for stale hooks.json configs (e.g., old timeout values from previous installs) and overwrite them with the canonical config. This prevents the "plannotator times out after 30 minutes" issue some users hit after updating from older versions (#230)
  • VS Code extension debounce fix — removed an unnecessary 1-second debounce guard that could delay panel opening when reviewing plans in quick succession (#231)
  • Tabbed help dialog — the "how does this work?" dialog now has two tabs: "Selection Modes" (new video covering Select vs. Pinpoint) and "How Plannotator Works" (the existing overview video)

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"]
}

Pi: Install or update the extension:

pi install npm:@plannotator/pi-extension

What's Changed

  • fix: include untracked new files in uncommitted/unstaged code review diffs by @zerone0x in #227
  • feat: VS Code extension for in-editor plan review by @backnotprop in #229
  • fix: validate plugin hooks.json on install by @backnotprop in #230
  • fix: remove 1-second debounce guard from VS Code extension panel opening by @backnotprop in #231
  • feat: pinpoint mode for point-and-click annotations by @backnotprop in #232

Contributors

Community members who reported issues and requested features that shaped this release:

Full Changelog: v0.11.0...v0.11.1

Don't miss a new plannotator release

NewReleases is sending notifications on new releases.