Plannotator

Follow @plannotator on X for updates

| Release | Highlights |
| ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| v0.11.3 | Expandable diff context, hierarchical folder tree, redesigned worktree controls, supply chain hardening |
| v0.11.2 | Git worktree support in code review, VS Code editor annotations in review, Obsidian auto-save & separator settings, session discovery, smart file resolution |
| v0.11.1 | VS Code extension for in-editor plan review, Pinpoint mode for point-and-click annotations, untracked files in code review |
| 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 |

What's New in v0.11.4

This release adds the ability to stage files directly from the code review UI and ships a batch of quality-of-life improvements across annotations, image attachments, and the VS Code extension.

Git Add from Code Review

Reviewing code and staging it used to be separate workflows — approve a file in the browser, switch to the terminal, git add it by hand. Now there's a "Git Add" button right in the file header. Click it to stage a file, click again to unstage. Staged files pick up a green tint and a "+" badge in the sidebar, so you can scan the file tree and immediately see which changes you've accepted versus what's still pending. The button is context-aware — it only appears when viewing uncommitted or unstaged diffs, and it works correctly inside worktrees. Staging a file automatically marks it as viewed.

The diff type dropdown also picks up two new options, "Staged changes" and "Unstaged changes", so you can filter the view down to just the files you've staged or just the ones left to review.

• Requested by @jgeralnik in #254

Bidirectional Scroll Navigation

Annotations in plan review now link the sidebar and the document in both directions. Clicking an annotation card smooth-scrolls to its highlighted text and applies a focused glow so you can spot it immediately. Clicking a highlight in the document scrolls the annotation panel to the matching card. For long plans with many annotations spread across the page, this eliminates the back-and-forth hunting between the two panes.

Authored by @grubmanItay.

Clipboard Paste for Annotation Images

You can now paste images from the clipboard directly into a per-annotation attachment popover with Cmd+V (macOS) or Ctrl+V (Windows/Linux). Previously, image attachments required either drag-and-drop or the file picker — clipboard paste only worked for the global attachments panel. The popover now shows a platform-aware shortcut hint in the drop zone so the capability is discoverable.

This PR also fixes an absolute path resolution regression introduced in v0.11.2's smart file resolution feature, where explicitly provided absolute paths outside the project root were incorrectly rejected.

• Authored by @dgrissen2

VS Code IPC Port Stability

The VS Code extension communicates with plannotator via a local IPC server on a random port, stored in the PLANNOTATOR_VSCODE_PORT environment variable. When VS Code restarted, the extension would bind a new random port, but restored integrated terminals still held the old port in their environment — breaking the connection silently. The extension now persists its port in workspace state and attempts to reclaim the same port on restart, falling back to a new one only if the old port is occupied.

• Reported by @7tg in #252

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

• feat: bidirectional scroll navigation between annotations and highlights by @grubmanItay in #253
• feat: clipboard paste for per-annotation images & fix absolute path resolution by @dgrissen2 in #255
• fix(vscode): reuse IPC server port across restarts by @backnotprop in #256
• feat: git add files from code review UI by @backnotprop in #257

Contributors

Community members who authored PRs, reported issues, and participated in discussions that shaped this release:

• @grubmanItay — authored #253 (bidirectional scroll navigation)
• @dgrissen2 — authored #255 (clipboard paste for annotation images, absolute path fix)
• @jgeralnik — #254 (git add from code review)
• @7tg — #252 (VS Code IPC port stability)

Full Changelog: https://github.com/backnotprop/plannotator/compare/v0.11.3...v0.11.4