github backnotprop/plannotator v0.29.1

one hour ago

Follow @plannotator on X for updates

Missed recent releases?
Release Highlights
v0.29.0 A redesigned code review window with two panes, a file tree, image diffs and a minimap, semantic diffs for moved and renamed code, talk through a review comment with your agent, Code review in the Inbox is a switch in Settings, hide a pull request or a repository, playback speed for videos, plannotator routine commands and a /create-routine skill
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

What's New in v0.29.1

TL;DR

  • New: Start the Inbox's agents in Rex, each in its own tab, on a Mac or on a Linux or FreeBSD server
  • New: Search inside the list's Filter menu when a section is long
  • New: Start a thread from a pull request's page in Reviews
  • New: /picture-it, a built-in skill that asks an agent for one page of pictures explaining a change
  • New: Questions that propose a change show it as Now and After
  • New: Threads side by side, a switch in Settings (off by default)
  • New: Status marks for every agent in the sidebar, a switch in Settings (off by default)
  • New: Tag a project, and filter the list and the Board by that tag
  • Changed: Play a sound now rings for every agent message by default; "when an agent asks you" keeps the old behaviour
  • Changed: The "N new" bar stays at the top of the list and says what came
  • Changed: On a computer where the Inbox has never run, nothing starts it until you run plannotator inbox, and Claude Code gets no Inbox tool until then
  • Fixed: In code review, the symbol hover card closed while the pointer was in it
  • Fixed: Your Inbox rules and reminder never reached sessions that connect over MCP
  • Fixed: Invisible or faint text in several built-in themes

v0.29.1 is mostly an Inbox release, with a round of fixes to the code review window that v0.29.0 introduced. Agents the Inbox starts can now run as tabs in Rex, the list's filter gets a search field, and a pull request's page can start a thread. On a computer where the Inbox has never run, it now stays off until you run it. The release has 56 PRs. Fifteen come from outside contributors: fourteen fixes from @rudycelekli, merged together in #3658, and one from @sx4im.

The Inbox turns on only when you run it

On a computer where the Inbox has never run, nothing starts it on its own any more. Claude Code gets no plannotator_inbox tool and no Inbox reminder, and a background start by a plugin or an agent's Inbox call answers with one line instead:

The Plannotator Inbox is off on this computer. plannotator inbox --open turns it on. If you are an agent, ask the person in the chat instead, and turn it on only if they ask you to.

The Inbox turns on when you run plannotator inbox yourself (bare, --no-open or --open; /plannotator-inbox runs --open), or when your agent runs plannotator inbox --open from the Inbox setup prompt. That first --open also connects the agents it finds, within half a minute.

If you have already run the Inbox on this computer, nothing changes: the first time Plannotator checks after the update, it sees that the Inbox ran here and records that once. One edge: a Claude Code session that already had the plugin loaded before you first turned the Inbox on needs one restart to get the tool, because a session decides at its start whether it has it.

#3729

Start agents in Rex

Rex is a terminal server with sessions, tabs and panes. The Inbox can now start its agents there instead of in the background.

Settings → Agents → Start new agents in has two choices: In the background (the default) and Rex. The row shows while Rex is running on this computer, or while Rex is already the choice. With Rex picked, a New message, or a reply that starts a session, opens a new tab named for the agent, in a Rex session the Inbox keeps for that project. The agent runs its ordinary interactive command there and keeps running after the Inbox closes. Rex's app is not brought to the front when a tab opens. Your message never goes on a command line; the agent receives it as its first turn through its own Inbox connection.

  • Claude Code, Pi and OpenCode can start in Rex. Codex always starts in the background, and so does every routine run, so a routine does not open a tab per run.
  • Where it lives. An agent in a Rex pane shows "Rex · session / tab" on its hover card, in the To picker and in its spoken name. This includes agents you started in Rex yourself, while Rex is the setting.
  • Show in Rex on the agent's menu moves Rex's app to that agent's tab. It needs Remote Control turned on in Rex's settings; if it is off, the Inbox says so.
  • Status marks. An agent in Rex gets a mark on its icon when its pane reports that it is working, waiting on you, done or failed.
  • Stop closes that agent's own tab in Rex and nothing else. Open in Terminal is not offered for an agent in Rex, because it would start a second process on the same session.
  • When Rex is not there, or does not open a tab, the agent starts in the background and the run line says why. A reply to an agent that stopped starts it again in a new tab, as the same session.

Rex also runs as a server on Linux and FreeBSD, with no app on that machine and apps attaching from other computers. The Inbox finds such a server in the places Rex's manual gives, and starts agents there without an app. Show in Rex then asks the Rex apps attached to that server. For an agent on a linked machine, Show in Rex goes through the machine link to the Inbox beside that Rex. A click made on another computer never moves a Mac's own Rex app.

The Inbox only talks to Rex through its existing socket, owned by your user. It never starts a Rex server, never types into a pane and never reads what a pane shows.

#3606, #3693, for #3303 from @tommyent

Search the list's filter

When a section of the list's Filter menu has more than eight rows, a Search filters field sits at the top of the menu. Typing narrows every section at once (Agent, Project, Tag, Pull request, Routine and the rest), bolds the matching part of each row and ignores case and accents. A section with no match goes away, and a row you already ticked stays so you can untick it.

The arrow keys move through the rows while the field keeps focus, Enter ticks a row and leaves the menu open, and Escape clears the field before it closes the menu. On a phone the field sits under the sheet's title, and opening the menu with a tap does not raise the keyboard. With short lists the menu is the same as before.

#3620

Start a thread from a pull request

On a pull request's page in Reviews, when no thread is about that pull request yet, the Review thread section offers Start a thread. The page turns into an empty thread for the pull request in place: its header line with title, branch, changes and checks, one line ("Ask anything about this pull request. Your first message starts the thread."), and the reply box. The reply box's To control lists this computer's live agents in the pull request's project, then a new session of each agent.

Nothing is made until you press Send. Your words come first in the message, and the pull request's details follow under a fold, "Sent with: this PR's details", which shows exactly what the agent received. From then on the pull request's row in Reviews and its page open that thread. Closed and merged pull requests, stacks of several pull requests, and pull requests outside a project do not get the button.

#3629

Picture it

/picture-it is a new built-in skill, first among the built-ins in the reply box's / list. It asks the agent for one self-contained HTML page that explains what you are discussing, mostly drawings with short labels: for a code change, what changed and why. The skill tells the agent to take file names, lines and numbers from the code or the thread, to make the page read at phone width and take your Inbox theme, and not to change code while it makes the page. The agent sends the page back in the same thread as an attachment.

The Inbox also recognises a page made this way from a mark in its head, and records which attachment it is. Nothing in the window uses that yet.

#3723

Before and after on a question card

A question that proposes a change, to words, a screen, code or a setting, can now show it. The agent writes Where:, Before: and After: lines, and the Inbox draws them as a quiet Now and After pair: removed words struck through on a red tint, added words on a green tint. A line that changes almost entirely is shown whole instead of marked word by word. A value can be a picture, and two pictures sit side by side on a wide card. Each choice can carry its own After:, so a question about three wordings shows three versions.

The agent tool's instructions, plannotator inbox --help before-after and the plannotator skill teach agents the format. Plan review, annotate and older Inboxes show these lines as plain text, and a question without them looks exactly as before.

#3714

Threads side by side

Settings → General → Appearance → Threads side by side is a new switch, off by default. Turned on, a thread's right-click menu offers Open to the side, and you can drag a thread next to the open one. The change applies at once in every open Inbox window, with no reload. Turned off, the Inbox works exactly as it does today. A phone always shows one thread, so the row is not shown there. If you had turned on the hidden preview in config.json (inboxSplitView), the switch is already on.

The panes themselves were also improved: Escape closes only the pane you are in, closing a pane by keyboard moves focus to the pane that is left, a column holds at most two panes, and the panes you are not in have a stronger grey header. When the window narrows and a pane steps aside, a toast says so, and the pane comes back when the window widens.

#3719

Agent status marks

Show agent status (Settings → General → Appearance, under Sidebar, and in the list's ⋮ menu) puts a status mark on every agent in the sidebar's Agents list, not only on agents in Rex. It is off by default. A mark shows when an agent is working, when it waits on a prompt where it runs ("Waiting for your permission in the agent" or "Waiting for your answer in the agent"), and when a thread waits on you. An agent at rest draws nothing. Marks show only in the Agents list, never on thread rows or the Board. A mark that could stay on "Waiting for your permission in the agent" when a prompt was answered within a second was fixed before release.

Permission and question prompts are reported by Claude Code (questions, and permission prompts for Bash on Claude Code 2.1.326 and later), OpenCode 2, Pi and Oh My Pi.

One part of this applies with the setting off: an agent that does not report when it is working (Codex, T3 Code, Antigravity and cloud agents, for example) is no longer called "Idle". Its hover card says "Doesn't say when it's working".

#3710, #3735

Tag a project

A project's ⋯ menu has Add tag, with the same tag list as a thread's menu. Picking a tag in the list's Filter then keeps threads that have the tag and threads in a project that has it, and the Board's tag filter does the same. This lets you see, say, every Work project together. Nothing looks different until you tag a project. Tags on a linked machine's project are kept on that machine.

#3697

Play a sound: for every agent message

Play a sound (Settings → General, under "When an agent sends you something") now has a choice: when an agent asks you (the behaviour until now) and for every agent message, which is the new default. With the default, a plain reply, a new thread or a question from an agent rings the bell. Either way it rings only while no Inbox tab is in front, once for a burst of messages within 30 seconds, and never for your own messages or for snoozed threads. If you had turned the sound off, it stays off.

#3695

The new-messages bar

The "N new · Show" bar above the list now stays at the top while you scroll, and says what came on one line, for example Claude Code replied in “Checkout redesign” · Show or 2 replies from Claude Code and Codex · Show. In a project or filter view, news from elsewhere gets a second line with Show all. The bar arriving no longer moves the rows you are reading. The floating New pill now shows only after you press Show, for rows that landed out of view.

#3616

Code review: the symbol hover card

Moving the pointer from a symbol into its hover card ("8 references") often closed the card a moment later, with the pointer still in it. It now stays open until the pointer leaves the card. The hover underline and hand cursor now show only on names that can open a card, so comments, keywords and ; no longer look clickable. The card's footer is one line: "Click to jump · ⌘ click for all references" (Ctrl+click on other systems).

#3728, #3732

Code review fixes

  • Lines no longer move under you when semantic notes arrive. Once you start reading (scroll, click, type or jump to a file), a file's moved and renamed notes that arrive later are offered in its header ("1 moved", one click shows them) instead of redrawing the file at a new height. Files below the view still get their notes as they arrive. #3674
  • Semantic diffs on a slow connection. The first download of the engine and of each language could hit the three-second limit and fail the file. A language's first answer now gets 30 seconds. Lines you open stay where they are, and with the semantic switch off no file header shows a semantic note. A comment on any old-side line inside a folded "Moved N lines" block now opens the block. #3662
  • Expand arrows. A mouse click on an expand arrow or on the "N unmodified lines" label sometimes did nothing, mostly in Safari, because the row was redrawn during the press. The click now always opens the lines. #3666
  • Two Git settings no longer change what a review reads. With diff.relative=true, a review started in a subdirectory showed only that subdirectory, and expanding, staging and unstaging broke. With log.showSignature=true, a signed commit's short SHA and subject were read wrong. Every review Git command now turns both off. #3664
  • File tree. Escape in an empty search box moves focus to the tree's current row instead of the page. A renamed file's tooltip reads old → new. On the Inbox PR page, switching between Changes and All files keeps focus on the switch. #3663
  • A review job that ends at once no longer shows Running forever. If a Guided Review or agent review finished (or failed) before the window had read the answer to its own start request, that late answer set it back to Running until a reload. A finished job now stays finished, and one that fails at once shows Failed. #3747
  • Review agent instructions say in plain words that missing tests are a finding only when a change adds non-trivial logic with no test coverage at all. #3703

Your Inbox rules reach MCP sessions

Sessions that connect to the Inbox over MCP, such as every session T3 Code starts, only ever saw the built-in server instructions. The rules and reminder under Prompts → Inbox reached sessions started from a terminal but not these. The MCP server now adds your rules for all agents, then your reminder, after its built-in lines, and follows the same reminder switch. How much room they get depends on the client: Claude Code 2.1.296 and later keeps more than older Claude Code and other Claude apps, and other clients get the terminal path's limit. Rules and reminder are each sent whole or left out whole, never cut. Settings → Prompts shows the count against Claude Code's room and a "Not sent to …" note when your text is too long for some agents. A change applies to the next session, with no restart.

By @sx4im in #3567, closing #3555 from @stjepanvrbic

Fixes from @rudycelekli

Fourteen fixes from @rudycelekli, merged together in #3658 with each pull request's commits and authorship kept:

  • Paired cloud agents saw computer_asleep while the computer was awake. The Inbox now pings its relay connection and replaces one that stopped answering. A follow-up keeps the connection through a slow, large upload, such as a video sent to a phone. #3636, closing #3577 from @kyletruong
  • Oh My Pi: /new, resume and fork move the Inbox connection to the new session, so replies reach it (#3644, closing #3564 from @omederos), and a session switch resets plan mode and closes the open plan review (#3650).
  • Less repeated work on list and status reads. Each session's restart check is worked out once per response. #3637, part of #3623 from @Arobotmaster
  • Pull request stacks rank the forge's default branch as trunk ahead of an older branch named main (#3639), and an open pull request stays in its stack through five merged layers (#3641).
  • Bulk actions: a failed later batch of a bulk hide or show no longer undoes the batches that went through (#3640), and a bulk merge confirmation resets when a picked pull request's head, base or machine changes (#3649).
  • Linked machines: a linked machine's Board is read again after its first read fails (#3646), and a Reviews read in flight is dropped when that machine is unlinked (#3647).
  • Review diffs: removed lines such as ---- or --- x count in a file's +/−, the same in the file tree, the file header and stack cards (#3642); paths with leading or trailing spaces are kept (#3643); and blank context lines read correctly whatever your diff.suppressBlankEmpty setting (#3651).
  • Comment boxes stay open when Escape only closes an input method's candidate list. #3648

Theme contrast

Some text in the built-in themes was hard or impossible to read.

  • Invisible text in Simple and Neutral. Text on red buttons, such as the Inbox's confirm button, the "This review was replaced" banner and the remove × on attachments, was the same red as the button, or nearly. It is now near-white.
  • Pale accent text in Simple, Neutral and Quantum Rose light now reads at 4.5:1.
  • Faint grey text in light themes. Muted text in light themes such as Min, Material, Solarized, Tokyo Night, One Light, Rosé Pine, Vitesse and the Everforest themes is darker, to at least 4.5:1. In six of them the body text is darkened too, so it still reads stronger than the grey. Dark modes are unchanged.

#3706

Which version of an attachment you are viewing

When an attachment opened beside a thread has changed since it was sent, the line above it now says which version is on screen, for example "Viewing the current file (edited 5:51 PM). Claude Code sent an earlier version at 3:41 PM." with View sent version, or "Viewing the version Claude Code sent at 3:41 PM." with View current file. Full screen's chip uses the same sentence and link.

#3704

Additional Changes

Known issues

  • Rex on Linux and FreeBSD has been tested against a stand-in for Rex's server, not a real one.
  • Threads side by side: narrowing the window does not fold the docked sidebar, so fewer panes fit than could, and Tab moves through panes in the order they were opened, not the order they sit on screen.
  • Code review: clicking the header of a file with opened lines still folds them back.

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

  • File tree: Escape focus, rename tooltip, focus after switching lists in #3663
  • Reconnect the Inbox when a relay socket stops answering by @rudycelekli in #3636
  • Reuse restart judgments in Inbox thread and status responses by @rudycelekli in #3637
  • Prefer the forge's default branch when grouping PR stacks by @rudycelekli in #3639
  • Keep successful entries when a later bulk hide or show fails by @rudycelekli in #3640
  • Keep an open PR attached through five merged stack layers by @rudycelekli in #3641
  • Count patch-marker-like lines in review hunks by @rudycelekli in #3642
  • Preserve whitespace in Git review paths by @rudycelekli in #3643
  • Move the Inbox wake when Oh My Pi switches sessions by @rudycelekli in #3644
  • Retry a linked Board after its first read fails by @rudycelekli in #3646
  • Discard linked Reviews reads when their machine is unlinked by @rudycelekli in #3647
  • Keep comment composers open on an IME Escape by @rudycelekli in #3648
  • Refresh bulk merge confirmation when its target changes by @rudycelekli in #3649
  • Restore plan mode when Oh My Pi changes sessions by @rudycelekli in #3650
  • Read Git hunks that omit blank context prefixes by @rudycelekli in #3651
  • Fourteen fixes from @rudycelekli, merged together in #3658
  • Review: pin diff.relative and log.showSignature off in review Git commands in #3664
  • Review: a click on an expand arrow always opens the lines in #3666
  • Inbox: Start a thread from a PR's page, an empty thread in place in #3629
  • Semantic diffs: opened lines stay put, switch off and on, slow links in #3662
  • Inbox: where an agent lives in Rex, Open in Rex, Show in Rex in #3606
  • Internal: move shared Inbox types in #3682
  • CI: internal change in #3677
  • Semantic diffs: notes that land after you started reading are offered, not swapped in in #3674
  • Internal: move question answer code in #3686
  • Internal: name a list row rule in #3688
  • Inbox server: internal change in #3678
  • Mobile: internal work in #3679
  • Mobile: internal work in #3681
  • Inbox: search the list filter when a section is long in #3620
  • Relay: internal change in #3680
  • Inbox: send your Inbox rules and reminder to MCP sessions by @sx4im in #3567
  • Mobile: internal work in #3684
  • Mobile: internal work in #3685
  • Mobile: internal work in #3699
  • Mobile: internal work in #3701
  • Review instructions: say plainly when missing tests are a finding in #3703
  • Inbox: the version line says which version you are viewing in #3704
  • Mobile: internal work in #3694
  • Inbox list: the N new bar sticks; the New pill shows only after Show in #3616
  • Fix blank text and faint light muted text in the built-in themes in #3706
  • Mobile: internal work in #3708
  • Inbox: tag a project, and let the filter pick the tag in the list and on the Board in #3697
  • Inbox: status marks for every agent, behind a setting in #3710
  • Show a proposed change on a question card: Where, Now and After in #3714
  • Fix a flaky test: a grammar download that never ends in #3722
  • Inbox sound: ring for every agent message, or only when an agent asks in #3695
  • Mobile: internal work in #3713
  • Inbox: a Settings switch for thread panes (off by default) in #3719
  • Review: keep the symbol hover card open while the pointer is in it in #3728
  • Rex on any server: Linux and FreeBSD servers, starts with no app, Show in Rex from other computers in #3693
  • Review: a one-line footer on the symbol hover card in #3732
  • Picture it: the /picture-it skill and the page mark in #3723
  • Agent status: a prompt set and cleared between two looks reaches the window in #3735
  • The Inbox turns on only when you run it in #3729
  • Review: a finished job stays finished when its launch answer arrives late in #3747

Contributors

@rudycelekli sent fourteen fixes this time, across the relay connection, Oh My Pi, pull request stacks, bulk actions, linked machines, review diffs and comment boxes (#3636 to #3651). They landed together in #3658 with each commit and its authorship kept. Two of them close reported issues: the dead relay socket and Oh My Pi's /new.

@sx4im made the MCP server carry your Inbox rules and reminder, sized to what each client keeps of its instructions, with a count and notes in Settings → Prompts (#3567).

Thanks also to the people whose reports shaped this release:

  • @stjepanvrbic reported that Inbox rules and the reminder never reached sessions connecting over MCP (#3555)
  • @kyletruong measured an idle Inbox losing its relay connection after about an hour and never reconnecting, leaving paired cloud agents with computer_asleep (#3577)
  • @omederos found that a session started with /new in Oh My Pi did not get Inbox replies, and traced it to the session switch event (#3564)
  • @Arobotmaster reported thread-list latency that depended on the session (#3623)
  • @tommyent asked for the Inbox to say where each agent runs (#3303), which the Rex work answers for agents in Rex

Full Changelog: v0.29.0...v0.29.1

Don't miss a new plannotator release

NewReleases is sending notifications on new releases.