Repository navigation
Follow @plannotator on X for updates
Missed recent releases?
| Release | Highlights |
|---|---|
| v0.28.8 | The Plannotator Inbox (preview): messages, questions, files and guided reviews from your agents in one local window |
| v0.28.7 | Ask this session keeps your drafts as drafts, image comments survive a reload, hostname check on every server |
| v0.28.6 | Ask AI names the lines you selected, reorder quick labels and edit their emoji, Pi fixed-port crash fixed, OpenCode 2 subagent notice fixed |
| v0.28.5 | Several files in one review, the plannotator tool on Pi and OpenCode 2, decisions name the exact file, Ask this session reconnects after sleep |
| v0.28.4 | Comments come back after the agent edits a file, the agent can list and close its reviews, PR-description feedback no longer dropped, Pi thinking levels |
| v0.28.3 | Typing into your agent while it answers an Ask no longer streams into Plannotator |
| v0.28.2 | Question cards show wrapped choices and tables, pinned images named by their file, Done with nothing to send starts no agent turn |
| v0.28.1 | Ask AI from diagram comments, pinned images named for the agent, OpenCode 1 URL toasts and one reply per feedback, folder feedback sent once |
| v0.28.0 | Ask this session in Claude Code, Pi and OpenCode 2, Claude Code mod on by default, Pi plan review no longer blocks, first-run demo |
| v0.27.25 | Code review works with color.diff = always, Bitbucket review fixes, wide tables no longer collapse in Firefox, install script fix |
| v0.27.24 | Image previews stay in the all-files view, PR comment previews open on the commented line |
| v0.27.23 | Bitbucket Cloud PR review, Question UI for answering agents in place, opt-in auto-update, viewed files remembered, review another repo or worktree |
What's New in v0.28.9
A patch release that follows up on the Inbox, which launched in v0.28.8. It fixes large messages sent through plannotator inbox mcp, gives the Inbox a sidebar you can close and resize, and smooths several rough edges found since the launch. It also turns on Edit Mode in reviews of several files and includes a first contribution from @h-jennings.
Large messages through plannotator inbox mcp
An agent connected through the stdio command (plannotator inbox mcp, the setup the Inbox shows for Codex, Gemini CLI and other MCP clients) could not send a message larger than 4 MiB. The Inbox refused it, but the refusal carried no request id, so the agent's MCP client never matched it to its request and waited until its own 60-second timeout. Messages now go through up to 128 MiB, and anything larger is refused at once with an error that names the limit. Claude Code, Pi and OpenCode report the same limit in the same words.
A sidebar you can close and resize
The Inbox sidebar now closes and opens from a toggle at the start of each page header, or with ⌘B (Ctrl+B), and the Inbox remembers your choice. ⌘B does nothing while you type in the reply box, so it never takes your focus away. While the sidebar is closed, resting the pointer on the left edge shows it for a moment. Drag its edge to change the width (the Inbox remembers that too), drag it narrow to close it, or click the edge to collapse it. In a narrow window it opens as a sheet over the list. Opening a file beside a thread closes the sidebar to make room and leaves your saved choice alone.
Smaller Inbox fixes
- Newest first in every section. Each section of the list (Stopped on you, Holding up work, Waiting on you, Sent, New since you looked, Quiet) is now ordered by the thread's latest message, so the time column reads down in order. Before, some sections put the oldest waiting question first (#1800)
- Rows show delivery without a reload. After your reply reached the agent, the thread said "Delivered" while the list row kept saying "Saved for " until you reloaded. The row now updates in place, and rows still change position only when you act (#1772)
- Agents that get your reply automatically end their turn.
send_messageandsubmit_guidetold every agent to callwait_for_reply, which could hold a Claude Code, Pi or OpenCode 2 session for up to 50 seconds per call even though your reply arrives there by itself. Those agents are now told to end their turn. OpenCode 1 and other MCP clients keep thewait_for_replyadvice (#1771) - A stale tab says Inbox. An Inbox tab left open after the Inbox restarted used to say "This review was replaced". It now says the Inbox page is out of date and nothing was saved (#1773)
- Attachments look like Plannotator. Markdown, text and diagram attachments follow the Grid or Clean look you chose in Plannotator's Settings (#1796)
Edit Mode in reviews of several files
plannotator annotate a.md b.md c.md opens one review of all the listed files, but that review had no Edit Mode, so an agent asked to set up documents for direct editing had to open a folder instead. Each file in such a review now has Edit Mode exactly when it would have it opened by itself: markdown, .mdx and .txt files can be edited and saved to disk, while raw HTML, diagram sources and data files stay read-only. Files linked from the review, and anything outside it, cannot be written. This works the same in the CLI and in Pi.
- #1802, from a report by @bendrucker in #1774
Additional Changes
- Drag a toast away. Pressing on a toast and dragging it used to select its text and leave it on screen, most often with the update notices. A drag now dismisses it, in plan review, annotate and code review (#1792 by @h-jennings)
- The new Pi logo. Plannotator now draws Pi's new three-colour logo from pi.dev wherever it shows the Pi mark: the Ask AI provider bar, AI settings, the Agents tab, and the Inbox list, threads and first-run cards (#1808)
- The Inbox on plannotator.ai. plannotator.ai/inbox now has a short film of the Inbox, alongside the launch post The age of the Inbox (#1770, #1811)
Install / Update
macOS / Linux:
curl -fsSL https://plannotator.ai/install.sh | bashWindows:
irm https://plannotator.ai/install.ps1 | iexClaude 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@plannotatorThen restart Claude Code. Inside Claude Code, run /plugin marketplace update plannotator, then open /plugin → Installed → plannotator → Update now.
Pi:
pi update --extensionsOpenCode: Re-run the install script above. It now also clears the OpenCode 2 plugin cache.
What's Changed
- Inbox MCP: large messages through the stdio shim no longer time out by @backnotprop in #1794
- Inbox: the Workspaces sidebar (close, open, peek, ⌘B) by @backnotprop in #1810
- Inbox: every section of the list reads newest first by @backnotprop in #1800
- Inbox: a held row's state follows a delivery; only the order waits for an action by @backnotprop in #1772
- Inbox: send result says to end the turn when the caller's wake delivers the reply by @backnotprop in #1771
- Inbox: a stale tab's 409 says Inbox, not review by @backnotprop in #1773
- Inbox: the attachment pane follows Plannotator's Grid/Clean plan look by @backnotprop in #1796
- Edit Mode in reviews of several files (annotate bundles) by @backnotprop in #1802
- fix(ui): a mouse drag dismisses a toast instead of selecting its text by @h-jennings in #1792
- Pi mark: the new pi.dev logo by @backnotprop in #1808
- Marketing: the Inbox is launched (INBOX_LAUNCHED on) by @backnotprop in #1770
- Marketing: the Inbox film on the Inbox page by @backnotprop in #1811
- Claude Code mod harness: expect the inbox-wakes _meta on plannotator_inbox calls by @backnotprop in #1793
- test: fix the restart-to-update and review-directory flakes by @backnotprop in #1783
- ci: manual sign-and-notarize check for an upcoming macOS app by @backnotprop in #1799
- iPhone app groundwork, included but not enabled in this release, across #1775, #1776, #1777, #1778, #1779, #1780, #1781, #1782, #1785, #1788, #1789, #1790, #1791, #1795, #1797, #1798, #1801, #1806, #1809 and #1812 by @backnotprop
New Contributors
- @h-jennings made their first contribution in #1792
Community
- @h-jennings fixed toasts that selected their text instead of dismissing when dragged (#1792), with before and after recordings in the PR. First contribution to the project.
- @bendrucker found that a review of several files had no Edit Mode and opened #1774 to point agents at the folder form instead. That report is why #1802 turned Edit Mode on for those reviews.
Full Changelog: v0.28.8...v0.28.9