backnotprop/plannotator v0.28.12

on GitHub

Follow @plannotator on X for updates

What's New in v0.28.12

An Inbox release, and update notices for everyone. Agents can now attach any file, and questions carry the context to answer them. Plannotator now tells you when a new version is out and can update itself in one click.

Update notices and plannotator update

Plannotator used to check GitHub from your browser on every page load, and its update hint showed the wrong command for Claude Code and Pi. Now the machine checks at most once a day, never while you work, and every window reads that one answer.

• In the Inbox, an Update button appears as soon as a new version is out. Its dialog puts Update now first, which runs the normal install script for you, and offers "Install new versions automatically". After an update, a What's new page lists what changed.
• In plan, annotate and code review, a small notice appears at most once per version and once every three days, with the right command for your agent.
• In the terminal, plannotator update installs the latest release, and plannotator update --check only reports.
• Turn it off in Settings, or set PLANNOTATOR_UPDATE_CHECK=0 or { "updateCheck": false } in ~/.plannotator/config.json. Off means no automatic request to GitHub at all.

"Update now" only works from the computer itself. Sessions you share over your network or tailnet show the command to run instead.

• #1830, #1833, #1835

Attach any file to an Inbox message

Agents can now attach any file you can read, from anywhere on the computer, not only Markdown, text and HTML from inside the project.

• Images show inline in the message, the way an email shows them, and again as tiles with thumbnails. Click one to open it beside the thread, comment on it, and mark it up.
• Code and scripts (.ts, .sh, .py, .swift and the rest) open highlighted, with comments on lines and ranges.
• PDFs and every other file are downloads.
• Comments on images and code reach the agent with your reply, like comments on documents.
• .env files are still refused, along with .env.* (except .env.example), *.env and .envrc.

Agents can also pass project_path to the Inbox tool, so a session working in a subfolder files its message under the right project.

• #1826, #1834

Questions with context, and links to attached files

The question guide every agent reads (the plannotator skill, plannotator inbox --help and the Inbox tool) now has literal rules. Agents give one to three plain sentences of context: what the choice affects, what they already know, and why they recommend what they do. They add a screenshot when the question is about something visual. You switch in cold, and a question should be answerable without opening anything else.

When an agent links a file it attached ([the mock](mock.html)), the link opens that file beside the thread. A link to a file that isn't attached shows as "Not attached" and loads nothing.

• #1829

Additional Changes

• Replies reach scripted agents. plannotator inbox mcp run from inside a Claude Code or Pi session now sends as that session, so your reply wakes the agent and its messages stay in one thread (#1831)
• Oh My Pi. Our Pi extension works in Oh My Pi as an OMP plugin (omp plugin install @plannotator/pi-extension). When Plannotator is started from OMP's terminal instead, Ask AI now says how to connect it to the session. The installer mentions it when it finds OMP (#1832, for #1814)
• Question cards. The "Records a decision" tag reads clearly as off when off, and the tags in a card's top row line up (#1816)
• The install script updates the Claude Code plugin you already have, so binary and plugin stay in step. Skip it with --skip-claude-plugin (#1824)

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

• Install scripts: update an installed Claude Code plugin by @backnotprop in #1824
• Question card: the off decision tag reads as off; the eyebrow pills align by @backnotprop in #1816
• Inbox: code files as attachments, and project_path on the plannotator_inbox tool by @backnotprop in #1826
• Questions: a little more context, and links to attached files open beside the thread by @backnotprop in #1829
• Inbox MCP: a command run inside an agent session sends as that session by @backnotprop in #1831
• Oh My Pi: point CLI sessions at the extension for Ask this session by @backnotprop in #1832
• Inbox: attach any file from anywhere; images, PDFs, files, comments on images and code by @backnotprop in #1834
• Updates: daily check, plannotator update, the Inbox Update button, review-window notices by @backnotprop in #1830, #1833, #1835
• Repo housekeeping: the iPhone app moved to its own home, docs cleanup (#1825, #1828, #1827)

Community

• @tedtramonte reported that Ask this session was missing in Oh My Pi in #1814, which led to the OMP fix and docs.
• Inbox users who wrote in about agents that never used the Inbox, about missing context in questions, and about files that couldn't be attached: most of this release answers those notes.

Full Changelog: v0.28.11...v0.28.12