backnotprop/plannotator v0.28.11 on GitHub

Follow @plannotator on X for updates

Missed recent releases?

Release	Highlights
v0.28.10	The Inbox over your tailnet with `plannotator inbox --tailscale`, images in agent messages load, click anywhere on an attachment tile
v0.28.9	Large Inbox messages through `plannotator inbox mcp` fixed, an Inbox sidebar you can close and resize, Edit Mode in reviews of several files, the new Pi logo
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

What's New in v0.28.11

A one-change Inbox release: plannotator inbox --help now teaches an agent how to use the Inbox.

`plannotator inbox --help` is a guide for agents

Until now plannotator inbox --help printed a few lines of usage. An agent with no Plannotator skill installed had no way to learn what the Inbox is for, how to send to it, or how to ask a question the person can answer on a card. Now the same command prints a complete markdown guide written for the agent:

what the Inbox is, and when to send something there instead of asking in the chat;
how to reach it: the plannotator_inbox tool where the agent has one, otherwise the stdio MCP server plannotator inbox mcp, and how an agent connects itself in Claude Code, Pi and OpenCode;
each of the eight tools and the arguments that matter, how threads and replies work, and where a reply arrives;
the question block syntax, the same text the plannotator skill carries, plus the Inbox-only Stopped:, Holds up: and Decision: when answered lines;
the setup line for each other agent (Codex, Cursor, VS Code, Gemini CLI, Zed and the rest), filled in with the absolute path of the binary on your machine;
the commands and flags, where the data lives, and that an agent must never uninstall or delete it for you.

The guide is built from the code: the tool list, the question syntax and the setup lines come from the same sources the Inbox itself uses, and tests fail if a tool, argument, flag or agent is added without it. plannotator --help, the plannotator skill and the docs now point agents at it.

The new "Copy install prompt" button on plannotator.ai/inbox relies on it: the prompt has your agent install Plannotator, start the Inbox, read plannotator inbox --help, connect itself and send you a first message.

#1822

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

Inbox: plannotator inbox --help prints a full guide for agents by @backnotprop in #1822
iOS CI: decisions-guides shard fixes by @backnotprop in #1820
iOS CI: pair-and-push and relay reply wait fixes by @backnotprop in #1821

Community

The Inbox users who wrote in after launch that their agents never wrote to it and that it was not clear how to get started. This guide and the install prompt are the answer to that.

Full Changelog: v0.28.10...v0.28.11