backnotprop/plannotator v0.28.4

on GitHub

Follow @plannotator on X for updates

What's New in v0.28.4

Seven PRs, one from a community contributor. Your comments now survive an agent editing the file, the agent can see and close the reviews it opened, and two fixes make sure everything you write reaches the agent.

Your comments come back after the agent edits the file

Annotate drafts used to be saved under the file's content. When an agent edited the file and opened a new review, your unsent comments didn't come back. Drafts are now also saved under the file's path, so reopening the file brings them back even after it changed. Comments whose text moved re-anchor to where the text is now, and comments whose text is gone are kept with an Unanchored tag instead of disappearing. This also works per file in folder reviews, so a file's comments carry between a folder review and a review of that file alone.

Exported feedback follows the same rule: a restored comment is labelled with the line its text is on now, and a comment whose text was deleted is sent without a line number rather than a wrong one. Sending your decision still clears the draft.

One visible change: a comment that can't find its text anywhere now always shows the Unanchored tag. Before, some of those (share-link imports, comments posted by outside tools) failed silently.

(#1710, #1717)

The agent can list and close the reviews it opened

With the Claude Code mod, the plannotator tool has two new actions. list shows the reviews opened in this conversation (by the tool or your /plannotator-* commands) with how many of your comments are unsent. close closes one or all of them. Closing works like your own Close but keeps your unsent comments as a draft, sends nothing back to the agent, and the tab says the agent closed it. Plan reviews are listed but can't be closed this way. Every result and decision message now carries a short session id (pn-…) so the agent can tell its reviews apart.

Review servers now refuse a second decision once a review is decided, so late feedback can no longer report success after a close and then be lost. With an older plannotator binary the mod only stops a review's process after confirming it is Plannotator; on CLIs 0.24 to 0.28.3 a decision made in the second before such a stop can still be lost, so update the binary.

(#1709)

Review feedback on the PR description no longer gets dropped

Code review used to treat any feedback with no code comments as the "posted to GitHub/GitLab/Bitbucket" status message. Comments on the PR description, PR comment notes and VS Code editor comments travel only in the feedback text, so a review made of only those was silently dropped under the Claude Code mod. The page now marks a real platform post explicitly, and every host (the Claude Code mod, OpenCode and Pi) delivers everything else, with the usual "address these changes" framing. The Claude Code plugin also guards against the old behavior when it runs with a plannotator binary from 0.28.0 to 0.28.3, but updating the binary is the real fix.

(#1719)

Pi's own thinking levels in Ask AI

When Ask AI uses the Pi provider (no connected session, for example in remote mode), each model now offers exactly the thinking levels Pi reports for it: no Off where the model can't turn reasoning off, Max and XHigh only where the model supports them, and no picker for models without reasoning. Auto sends nothing and leaves Pi's default. Levels are only offered on Pi 0.84.3 or newer, because older Pi versions saved the chosen level as your global default. Model names now read "Name (provider)".

(#1704, by @josdirksen)

Additional Changes

• One-click 👍 on HTML elements. Clicking an element on an HTML page opens the comment box, which now has a small 👍 button again. One click marks the element (or a shift-clicked group) "Looks good". It turns off as soon as you type, so it can't throw away a comment (#1712).
• Cleaner note boxes. The keyboard hints under the header's note composer, the small-screen note dialog and the review sidebar's general comment box are gone. ⌘↵ still sends and Esc still goes back (#1711).

Install / Update

macOS / Linux:

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

Windows:

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

Claude Code Plugin: The plugin and the plannotator binary update separately, so run the install script above as well. In a terminal:

claude plugin marketplace update plannotator
claude plugin update plannotator@plannotator

Then restart Claude Code. Inside Claude Code, run /plugin marketplace update plannotator, then open /plugin → Installed → plannotator → Update now.

Pi:

pi update --extensions

OpenCode: Re-run the install script above. It now also clears the OpenCode 2 plugin cache.

What's Changed

• feat(pi): offer Pi's thinking levels in Ask AI by @josdirksen in #1704
• fix(ui): drop the keyboard hint under the decision note composer by @backnotprop in #1711
• feat(ui): bring the one-click thumbs-up back to the HTML pinpoint composer by @backnotprop in #1712
• feat(tool): contract v2 with session ids, list and close by @backnotprop in #1709
• Annotate drafts follow the file's path by @backnotprop in #1710
• fix(review): mark the PR-platform status post explicitly by @backnotprop in #1719
• fix(annotate): true line labels and Unanchored chips after a restore across an edit by @backnotprop in #1717

Contributors

@josdirksen brought Pi's thinking levels into Ask AI, reading them from the installed Pi so each model offers exactly what it supports.

Full Changelog: v0.28.3...v0.28.4