backnotprop/plannotator v0.27.20

on GitHub

Follow @plannotator on X for updates

What's New in v0.27.20

Six pull requests, two of them from first-time contributors. Plannotator now supports Mistral Vibe, annotate sessions get the same Options menu and Settings as plan review, jj reviews get the Commits panel, and long lines in plan code blocks wrap. The installer also stops printing sections for tools you do not have.

Mistral Vibe support

Mistral Vibe is now a first-class host. On macOS and Linux, the installer detects Vibe when its home folder exists and adds a plan-review hook on Vibe's exit_plan_mode, so plans open in Plannotator for approval or feedback the way they do for Claude Code and Codex. Vibe's tool sends no plan in its payload, so the hook reads the plan the session just wrote from its transcript, and falls back to the newest plan in $VIBE_HOME/plans only within a short window. The installer also adds /plannotator-review, /plannotator-annotate and /plannotator-last skills for Vibe, and plannotator uninstall removes everything it added while leaving your own Vibe hooks in place.

On Windows, the installers do not configure the hook and do not install the Vibe-specific skills, because Vibe on Windows may run commands through PowerShell. Review and annotate still work there through the shared skills; /plannotator-last is not supported for Vibe on Windows yet. Nothing changes for anyone who does not use Vibe: detection only reacts to Vibe's own hook payload, and the installer only touches Vibe when its home folder already exists. Opt out with --skip-vibe, PLANNOTATOR_SKIP_VIBE_INSTALL=1, or { "skipInstall": { "vibe": true } }.

(#1480, by @Djiit)

Annotate gets the full Options menu and Settings

Annotate and plan review are the same app, but annotate sessions were missing parts of the Options menu and several Settings tabs. They now match plan review: Copy agent instructions, the Display settings, Default Save Action, quick labels, and the Obsidian, Bear and Octarine settings all appear in annotate. Only the settings tied to a plan decision stay plan-only: Save Plans, Hooks, Permission Mode and the Archive tab.

Copy agent instructions in annotate hands an agent instructions written for documents rather than plans, including how to comment on HTML elements, diagram nodes and documents in a folder session, so an agent can post review comments into a live annotate session. Two controls that appeared but did nothing are gone: Agent Switching in annotate, and "Save to Obsidian/Bear" on HTML, live-app and empty folder sessions, which have no text to save. The Obsidian, Bear and Octarine switches are shared with plan review, and annotate now says so: turning one on also saves each approved plan there.

(#1602)

Commits panel for jj reviews

The Tree | Git status | Commits toggle only offered Commits for plain git reviews, so jj users, including repos where jj and git live side by side, never saw it. jj reviews now get the same panel: your line of work from the working copy back to where it split from trunk, following first parents, with an @ marker on the working copy and jj's short change ids on each row. Clicking a revision shows only that revision's changes against its first parent, headed by its description, with hunk expansion and image previews working as usual. If you save a file while viewing your working copy, the view shows "Diff out of date" and Refresh opens the current version. This needs jj 0.33 or newer; older versions get a clear message.

(#1604)

Long lines wrap in plan code blocks

A long line in a plan's code block ran off the edge of the card and had to be scrolled sideways. Code blocks now wrap long lines, including long URLs and hashes. Blocks laid out as a grid, such as ASCII box diagrams and space- or tab-aligned tables, keep their layout and scroll as before, since wrapping would break their alignment. Copying a code block still copies the original lines.

(#1603, by @paulmelero)

Additional Changes

• Installer only shows the tools you have. The closing summary of install.sh, install.ps1 and install.cmd now prints the Pi, Gemini, Codex, Kiro and Vibe sections only when that tool is detected. A detected tool you chose to skip still reports "detected, skipped". What gets installed is unchanged. (#1606)
• Guided Review prompt available in @plannotator/core. The guide prompt, its output schema, the output validator and the user-message builder moved into @plannotator/core (0.25.6) so other hosts can generate guides with the exact same prompt. Plannotator's own behavior is byte-for-byte unchanged. (#1605)

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".

Pi: Update @plannotator/pi-extension to 0.27.20 and restart Pi.

OpenCode: Clear cache and restart:

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

What's Changed

• fix(annotate): plan-review Options menu and Settings parity in annotate by @backnotprop in #1602
• fix(editor): wrap long lines in plan code blocks by @paulmelero in #1603
• feat(review): Commits panel for jj sessions by @backnotprop in #1604
• core: move guide prompt, schema, user message and validator into @plannotator/core by @backnotprop in #1605
• feat(vibe): add first-class Mistral Vibe support by @Djiit in #1480
• installer: print agent closing sections only for detected agents by @backnotprop in #1606

New Contributors

• @Djiit made their first contribution in #1480
• @paulmelero made their first contribution in #1603

Contributors

@Djiit built Mistral Vibe support end to end: origin detection, the plan-review hook that finds the plan a session just wrote, Vibe skills, installer and uninstaller wiring, and tests. They worked through two rounds of review, checked the upstream Vibe source themselves, and kept the branch current with main. We added a few follow-ups on top before merging.

@paulmelero fixed long code lines overflowing plan code blocks, with before and after videos that made the problem easy to see. We extended it so diagrams and aligned tables keep their layout.

Full Changelog: v0.27.19...v0.27.20