Skip to content

v0.29.0

Latest

Choose a tag to compare

@github-actions github-actions released this 18 Nov 08:02
Immutable release. Only release title and notes can be modified.
55e6bbd

Follow @plannotator on X for updates

Missed recent releases?
Release Highlights
v0.28.67 Drag threads to Priority, Archive or Quiet, or onto another thread to combine them, mention another thread in your reply, Linear hover cards, pick any tag colour, a linked computer's pictures and files open here, pull request cards say why they could not load
v0.28.66 Pick several threads and archive or snooze them at once, combine picked threads into one; Tidy follows your own words, rows take their tag's colour; filter and search by tag, files an agent's message names open beside the thread, swipe rows on phone or iPad; list can show archived threads, Antigravity and Orca use the Inbox; T3 Codex threads get replies, Open in lists JetBrains IDEs, Routines: run a saved prompt on a schedule
v0.28.65 Take back a reply your agent has not received yet, over Tailscale, Plannotator opens only for your own account, tag a linked machine's threads; one tag across machines, T3 Code threads get the Inbox with no setup, long threads open on slow connections
v0.28.64 Installs and updates download a smaller, compressed copy, a Videos filter on the Artifacts page, GitLab comments on a whole file get their own thread, pull request pictures and videos show in the Inbox
v0.28.63 Pair Grok Bot and other cloud agents from Settings, Hermes Agent, OpenClaw and Muse Code can use the Inbox, add a thread to Priority to keep it on top, tag threads, and find each tag in the sidebar, Pull requests board as a table, with bulk Merge
v0.28.62 Agents started from the Inbox now work on Windows, pick a model and effort when you start an agent, rules for your agents, written in your own words, post a thread's decisions on its pull request, the Inbox loads faster on a slow connection
v0.28.61 Updates now update the Claude Code plugin too, an agent's chosen face shows on every icon of it, filter the Inbox list by pull request state, Modern dark shows section bands and the Reply button, one conversation no longer shows as two agents
v0.28.60 Click a word to highlight it, a one-time Themes dialog, Settings → Rows rebuilt, tell your agent how you want your rows, starred threads as pills above the list, a pill for new messages out of view, a half-circle face picker with ten Glass colours, a new phone sidebar and reply box
v0.28.59 A quieter Agents section in the sidebar, machine names only when agents run on more than one machine, agent icons that are always gently alive and lean toward your pointer
v0.28.58 Start Codex from New message, an Agents section in the sidebar, start an agent in a folder on any drive, play audio attachments and comment at a moment, Claude Code's Plannotator tools work on Windows
v0.28.57 Pin artifacts, and see every artifact on one page, filter the list by project, date or agent, a thread shows its pull requests and their state, choose what the sidebar shows, and in what order, Ask AI starts from Side in the selection bar
v0.28.56 Questions can show trade-offs and a prototype to try, a thread with many big pictures no longer crashes the tab, Escape closes New message and keeps your draft, read threads stop being bold and keep their place, agent messages that name no thread start a new one

What's New in v0.29.0

TL;DR

  • New: A redesigned code review window: two panes, a faster file tree, image diffs and a minimap
  • New: Semantic diffs: moved, renamed and reformatted code drawn as what it is, in eleven languages
  • New: Comment in a code review and talk it through with your agent, through the Inbox
  • New: Code review in the Inbox is now a switch in Settings → Capabilities (off until you turn it on)
  • New: Hide a pull request or a whole repository from Reviews and the PR board
  • New: Playback speed for videos and recordings in the Inbox
  • New: Routines: plannotator routine commands, a /create-routine skill, Edit and Runs tabs, a list filter
  • Fixed: On Claude Code 2.1.326 with a Team or Enterprise account, the agent could not open Plannotator
  • Fixed: A linked machine whose Inbox started before Tailscale stayed "asleep"
  • Fixed: Typing in the reply box on very long threads lagged, and undo took back one letter at a time
  • Removed: Code Tour

v0.29.0 is the code review release. The review window that plannotator review and /plannotator-review open has been rebuilt: a new file tree, two panes with tabs, semantic diffs, image diffs, a minimap, one launch pad for guided reviews and review agents, and review comments that become conversations with your agent. In the Inbox, the Code review switch is now in Settings for everyone. The release also fixes two problems that stopped things working: Plannotator could not open from the agent on Claude Code 2.1.326 for Team and Enterprise accounts, and a linked machine could stay unreachable after Tailscale came back. The release has 48 PRs. Thirteen come from outside contributors: twelve fixes from @rudycelekli and a playback speed menu from @MaxKless, their first contribution.

Fixed: Plannotator would not open from the agent on Claude Code 2.1.326 (Team and Enterprise)

Claude Code 2.1.326 added an "early run" rule to its built-in cc-plugin-sec-default guard, which is on for Team and Enterprise accounts and on machines with managed settings. The rule refuses a plugin that starts a program repeating a tool call the model just made. Plannotator's Claude Code plugin starts the review window at exactly that moment, so on these accounts an agent's plannotator call (annotate, review, last) failed with:

Plannotator could not start: plannotator: $.process.run: this repeats a Bash call that is not allowed; serve an allowed call at tool.run

A Bash(plannotator:*) allow rule did not help. Slash commands you typed yourself, such as /plannotator-review, still worked, and so did the Inbox.

The plugin now waits for the tool's run step, where the guard allows it, and opens the window there. On a guarded machine the call first goes through your session's own permission check (your rules, mode or a prompt), as the guard requires. On older Claude Code versions nothing changes. One cost remains on guarded machines whose organization has its own tools, such as managed MCP servers or organization plugins: Claude Code may print one "plannotator: its hook was skipped" line per session. It is harmless, and it does not stop Plannotator from opening.

This was tested on Claude Code 2.1.287, 2.1.325 and 2.1.327 against a stand-in that follows the guard's rule, not on a guarded account itself. If Plannotator still does not open for you on a Team or Enterprise account after updating, please open an issue with the message you see.

#3619

A new code review window

The review window has been rebuilt from the file tree out. Everything it did before still works, with these changes:

  • A new file tree. Changes and All files are one fast tree, built on Pierre's tree library. Group files by kind (Code, Docs, Tests, Generated) or by Git status (Committed, Staged, Unstaged, Untracked) from the tree's menu. Git status is no longer a separate tab: pick that grouping and it opens the same way. Git add and unstage sit on each row, long names shorten in the middle and keep their extension, and the arrow keys move through files and open each one.
  • Two panes and tabs. "Open to the side" puts a second file beside the first, with a divider you can drag. Tabs sit in the header row, so opening a file never pushes the code down. Each tab can show the Diff, the Current file or the Original. A review you open again comes back with the same panes, tabs and divider.
  • Image diffs. A changed image shows side by side, as a swipe with a divider you drag, or as an onion skin with an opacity slider. Highlight differences tints the pixels that changed, and an SVG can show as an image or as source.
  • A minimap at the right edge of long diffs shows where the changes and comments are. Click it to jump there.
  • One launch pad in the Agents tab: Guided Review and Review agent, each with a Start button that uses your saved picks. Your saved guides for this repository are listed under This diff, This PR and Earlier, with how much you have read, and can be renamed, downloaded, shared or deleted. Past runs list their findings by rank, and a click goes to the most serious one.
  • Collapse all files sits in the top bar. On a commit-by-commit review, Expand all now stays on as you step from commit to commit.
  • Cmd/Ctrl-click on a name now jumps straight to its definition when there is exactly one. Otherwise it opens References, as before.
  • Large diffs open and scroll faster, and a tap right after a scroll is no longer lost.

Removed: Code Tour, with its dialog, settings and Mod+Shift+T shortcut. A review saved in tour mode opens as a normal code review. The nine first-run announcements in the review window are gone too.

#3383, #3605, #3618

Semantic diffs: moved and renamed code, drawn as such

A plain diff shows moved code as a deletion in one place and an addition in another. With semantic diffs, the review window draws it as what it is:

  • Moved code folds into one "Moved N lines" row in its old place, with a band to where it went. Code that moved and also changed stays open, in purple.
  • A rename highlights only the name that changed.
  • Code that was only reformatted is drawn quiet and grey, so a real edit next to it stands out.
  • Each block is labelled moved, moved & edited, renamed, reformatted, extracted or inlined. Each file header has a sem N menu listing that file's changes, and the Semantic diff tab lists every change in the review by name, for example rate -> taxRate. A row in either one jumps to the change.

It reads TypeScript and TSX, JavaScript, Python, Go, Rust, Java, C#, PHP, Ruby, Kotlin and Swift. The work happens in your browser, and no code leaves your computer for it. Other files, and anything that takes longer than about three seconds, keep the normal diff. Turn it off with Show moved & renamed code in the diff display options, or turn off the whole feature with Settings → Analysis → Semantic changes.

Power Up (Settings → Semantic diffs) is an optional second look by a model, for changes the engine could not label on its own, such as code extracted into a new function. It is off until you add a key for one of its two models. When it is on, the code in question goes to the model you chose. You can turn down a link it draws.

The Inbox PR page now draws semantic diffs too, with the same switch in its diff options.

#3383, #3630, #3625

Talk through a review comment with your agent

When the Inbox is running, a comment in the review window can go straight to your agent as a conversation. Type @ in the comment box to pick a connected agent and send it now, or leave comments as before and use Send or Send all in the new Threads tab. Send all goes to the agent as one review, with each comment as its own thread.

Replies show under the lines they are about, with Queued, Delivered and Read, a reply box, and Resolve. If the code changes under a thread, the thread stays on the lines that took its place and shows the old code. If the code moved, the thread follows it. Each conversation is an ordinary Inbox thread, and Open the review of … in that thread's header opens the review again with its threads in place.

The first comment goes to the agent that opened the review (Claude Code, Pi and OpenCode). Without a running Inbox, the comment box works as it did.

#3383

Code review in the Inbox, now in Settings

Settings → Capabilities → Code review is now shown to everyone. It is off until you turn it on, and the Inbox does not offer it in a pop-up. If you already had it on, it stays on. Turning it on gives you:

  • Reviews in the sidebar: your agents' reviews and your open GitHub and GitLab pull requests in one list, with a project filter. Type / in a reply to ask an agent for a review, then approve it, send feedback to the agent, or post it on the pull request.
  • The Pull requests board, as a grid or a table, Open or Merged, with bulk actions. It now follows the project chosen in Reviews, and its running checks mark turns while checks run.
  • PR pages with the same file tree as the review window and semantic diffs. Your unsent comments and Viewed ticks stay until a new commit lands, even when someone adds a label or a comment. When you send feedback on a pull request you opened yourself, the agent makes the change and pushes it to the branch. On a teammate's pull request it still changes nothing unless you ask.
  • Hide for a pull request (row menu in Reviews, the PR page bar, the board's tile and select mode) and for a whole repository (its header on the board). Hidden pull requests leave Reviews, the board and every count, and nothing is done on GitHub or GitLab. Each Hide has Undo, and a Hidden fold at the end of Reviews lists them with Show again. A hidden pull request stays hidden through new commits and comments until you show it again.
  • Set risk rules: describe in your own words what makes a pull request risky, and an agent ranks each open pull request High, Medium or Low against them, with one sentence why. It runs only once you have written rules.

Code review in the Inbox is separate from plannotator review, which works the same with the switch on or off.

#3626, #3610, #3613, #3609, #3627, #3612, #3628, #3653, #3622, with earlier work in #2640 and #2694

Fixed: a linked machine stayed "asleep" after Tailscale came back

Two faults on the far machine kept a linked machine unreachable:

  • An Inbox that started while Tailscale was not running never published its link for other machines, and never tried again. It now checks for Tailscale after 30 seconds, then less and less often, up to every five minutes, and publishes the link as soon as Tailscale runs. While the link is up, it checks every ten minutes that Tailscale still points at it.
  • After an Inbox crashed or stopped while Tailscale was off, the mapping it left behind pointed at a port where nothing listened. The next Inbox refused it as someone else's mapping. The Inbox now remembers the mappings it made and points its own dead ones at the new run. A mapping it did not make, or one in use, is never touched.

#3614

Typing on long threads

On a heavy page, such as a list of about 550 threads or a thread of about 600 messages, every key in the reply box did work that grew with the page, so holding Backspace could fall seconds behind. Each key now does a fixed, small amount of work. Chrome's undo also takes back a whole run of typing again instead of one letter at a time, and a pick from the /, $ or @ list is its own undo step. That last part is for Chrome and other Chromium browsers; Safari is listed under Known issues. A /, $ or @ list now opens only when you type, not when you delete back into a trigger.

#3603, #3632

Routines

For people who use Routines:

  • Agents can make routines. plannotator routine create|list|get|update|on|off|run|delete covers every field of the editor. The Inbox has a built-in /create-routine skill that teaches an agent how. A routine an agent makes arrives off, and only you turn it on the first time. When you ask for it yourself with /create-routine, that request counts as your approval, and the routine is made on.
  • Edit and Runs tabs on each routine. Runs lists the newest 20 runs, each one a link to that point in the thread. The Edit tab shows how the last run went, in red when it did not start or did not finish.
  • Filter the list by routine. The list's Filter has a Routine group: "Routine threads" and "Other threads".
  • A one-time intro to Routines, with No thanks and Turn on, shown once to people who have sent messages in the Inbox on three different days.
  • Two fixes from @rudycelekli: rescheduling a one-time routine while its run was getting ready no longer runs the old time and marks the new one Done (#3545), and two windows editing the same routine no longer undo each other's changes or bring back a deleted routine (#3552).

#3601, #3596, #3615, #3604

Playback speed for videos and recordings

Videos and recordings in the Inbox have a speed menu: 1x, 1.2x, 1.5x, 1.7x and 2x. The speed you pick applies to every video and recording you open in that tab until you close it. On a video, the "1x" chip sits in the line under the film, so it never covers the browser's own controls. On a phone, the menu opens as a sheet.

By @MaxKless in #3534, their first contribution, finished in #3582 with their commits kept

Fixes from @rudycelekli

@rudycelekli sent twelve fixes, each with a test that failed before it:

  • Last commit on a branch with one commit now shows that commit. Before, it showed nothing on a clean checkout, or your uncommitted edits. #3547
  • Before the first commit, Uncommitted changes and Since base now include files you have staged with git add. #3551
  • Staging row[1].txt from the review tree no longer also stages row1.txt. Stage and unstage now take the file name literally. #3544
  • A submodule change shows as its normal one-line pointer change whatever your diff.submodule setting is. #3542, related to #3533 from @luwanglin
  • OpenCode Ask AI reports a prompt that OpenCode rejects, such as an unknown model, instead of waiting for a reply that never comes (#3548), and no longer starts a second opencode serve when it is stopped during startup (#3543).
  • Linked documents in plan review and annotate open in the order you clicked them, and a note you add while the next file loads is kept. #3550
  • Restoring an annotate draft no longer drops an older note when a new one arrives from the same source. #3546
  • An MP4 you upload to the Inbox keeps its length and size, and an audio-only MP4 shows as a recording, as it does when an agent attaches it. #3549
  • The two routine fixes listed under Routines (#3545, #3552), and a fix to how CI picks the browser tests for a change when a path has unusual characters (#3541).

Ten of them landed together in #3624, with each commit and its authorship kept.

Additional Changes

  • Your Inbox rules reach Claude Code sessions the Inbox starts. The rules under Prompts → Inbox ("Rules for your agents") reached sessions you started in a terminal, but a session started from the Inbox only got them after a compaction. They now come with its first wake. #3594
  • Pick an OpenCode agent at launch. With OpenCode picked in To, the model menu has an Agent column: Default, build, plan and any primary agents you made. The thread's start line names it, and a reply that starts OpenCode again keeps it. #3621
  • Contents for short documents. A Markdown document opened in the Inbox shows its Contents rail from two headings, not four. #3621
  • Remove a link from a Board card. Each link in an opened card has a quiet ×. The card's history says what was removed. #3621
  • Groundwork with no visible change: card parts for host apps in @plannotator/ui, and Inbox work that stays off. #3572, #3579, #3581, #3586, #3587, #3569, #3570, #3584
  • Test upkeep: #3608

Known issues

  • Python docstrings. A change inside a docstring can be labelled "reformatted" in a semantic diff, so it is drawn quiet and grey although the words changed.
  • Semantic diffs on a phone. The moved and renamed bands show without their labels, and the switch to turn them off is not offered there.
  • Comments in a folded moved block. Commenting on lines inside a folded "Moved N lines" block opens the fold only when the comment sits on the old side's hidden lines. A comment that starts inside the block and ends outside it leaves the block folded.
  • The file tree's search box shows what you type in lower case. The search itself is not affected.
  • Undo after a pick in Safari. In the reply box, one undo right after picking from the /, $ or @ list empties the box. Redo brings it back. Chrome is not affected.
  • Opened lines can move on a pull request page. If you open hidden lines in a file during the first few seconds, before the moved and renamed notes have arrived for the files above it, those lines shift by a few rows when the notes arrive. Nothing is lost; scroll back to them. Opening lines after the notes have drawn is not affected.
  • Safari: an expand arrow may need a second click while a file's header still says "reading…".

Install / Update

macOS / Linux:

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

Windows:

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

Claude Code Plugin: The install script above also updates the plugin when claude is on your PATH. Otherwise, in a terminal:

claude plugin marketplace update plannotator
claude plugin update plannotator@plannotator --scope user

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

Pi:

pi update npm:@plannotator/pi-extension

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

What's Changed

  • Inbox: internal groundwork, off in #3569
  • UI frame: card parts for host apps in #3572
  • Inbox: internal groundwork, off in #3570
  • UI frame: card grid gap by size; the focus ring's colour in the docs in #3579
  • UI frame: card rows and a visible row focus in #3581
  • Inbox: playback speed menu for videos and recordings (1x to 2x) by @MaxKless in #3534
  • Inbox: playback speed menu under the film, a sheet on a phone (finishes #3534 by @MaxKless, with their commits) in #3582
  • Inbox: internal groundwork, off in #3584
  • UI frame: card rows keep their title in narrow lists in #3586
  • UI frame: plain names in the card example in #3587
  • Claude Code: a session the Inbox starts gets your Inbox rules on its first wake in #3594
  • Routines: Edit and Runs tabs on a routine in #3596
  • Code review redesign: file tree, two panes, semantic diffs, image diffs, minimap, launch pad, live review threads; Code Tour removed (carries #3324, #3331, #3332, #3337, #3338, #3340, #3342, #3347, #3349, #3353, #3357, #3360, #3361, #3389, #3391, #3394, #3408, #3413, #3417, #3428) in #3383
  • Inbox: plannotator routine commands and the /create-routine built-in skill in #3601
  • Fix a flaky selection bar browser test in #3608
  • Inbox: a one-time Routines intro after three days of use in #3604
  • Code review: fixes from the 0.29.0 hands-on QA in #3605
  • Inbox typing on long threads: no per-key page-wide work; Chrome undo per typing run again in #3603
  • Reviews: the risk dialog is titled Set risk rules in #3612
  • Report rejected OpenCode Ask AI prompts instead of waiting for a reply by @rudycelekli in #3548
  • Keep OpenCode Ask AI startup from spawning a duplicate server after disposal by @rudycelekli in #3543
  • Review: Expand all stays on from commit to commit; Cmd/Ctrl-click jumps to one clear definition in #3618
  • Board: show the selected segment in dark theme in #3622
  • Claude Code: open behind the guard's early-run rule at the tool's run step in #3619
  • Filter routines in the Inbox list in #3615
  • Inbox: publish the link for other machines once Tailscale runs; re-point a dead mapping the Inbox made in #3614
  • Fix browser slice selection for Git-quoted paths by @rudycelekli in #3541
  • Preserve submodule pointer hunks in Git reviews by @rudycelekli in #3542
  • Stage and unstage review filenames literally by @rudycelekli in #3544
  • Keep a rescheduled Inbox routine from being marked done by its old run by @rudycelekli in #3545
  • Keep distinct external comments when restoring annotate drafts by @rudycelekli in #3546
  • Preserve audio and video metadata when people upload to the Inbox by @rudycelekli in #3549
  • Keep linked document navigation ordered and preserve pending edits by @rudycelekli in #3550
  • Include staged files in working-tree reviews before the first commit by @rudycelekli in #3551
  • Preserve concurrent changes when editing Inbox routines by @rudycelekli in #3552
  • Ten fixes from @rudycelekli, merged together in #3624
  • Inbox: hide a pull request from Reviews and the PR board in #3610
  • Show the first commit in Last commit reviews by @rudycelekli in #3547
  • Show the Code review switch in Settings to everyone; never show its offer in #3626
  • Board: same surface as the list beside it; running checks turn in #3628
  • Inbox: Contents for short documents, remove a card link, OpenCode's agent at launch in #3621
  • A pick from the skill or @ list is its own undo step in #3632
  • Release batch: Code review switch, board surface, Inbox small fixes, undo after a pick in #3634
  • PR board: follow Reviews' project filter; Hide repository in #3613
  • Inbox: the PR page's file list is the code review tree in #3609
  • Inbox window: draw diffs with the vendored diff library fork in #3625
  • File tree: arrow keys work after a search; 44 px All files rows on a phone in #3627
  • Inbox PR page: semantic diffs (moved and renamed code) in #3630
  • Reviews: name the filtered project when everything in it is hidden; leave select mode after a bulk hide in #3653
  • Inbox PR page: an expand arrow used before a file's moved and renamed note arrives no longer leaves its header on "reading…" in #3656

New Contributors

Contributors

@rudycelekli sent twelve fixes across code review, annotate, OpenCode Ask AI, Inbox uploads and Routines (#3541 to #3552). Each one came with a test that failed before the fix, most of them against a real Git repository: the first commit in Last commit reviews, staged files before the first commit, file names with brackets, submodule pointers, rejected OpenCode prompts, a duplicate OpenCode server, linked document order, annotate drafts, uploaded video details, and two races in Routines.

@MaxKless built the playback speed menu for Inbox videos and recordings (#3534), with keyboard and screen reader support and tests, and recorded it in Chrome, Safari and on a phone. It ships in #3582 with their commits kept. First contribution.

Thanks also to @luwanglin, who asked for code review to cover submodules in #3533. #3542 makes the submodule pointer show the same way under every Git setting; reviewing inside a submodule is still open there.

The new review tree and diffs are built on Pierre's @pierre/trees and @pierre/diffs libraries.

Full Changelog: v0.28.67...v0.29.0