Repository navigation
Follow @plannotator on X for updates
Missed recent releases?
| Release | Highlights |
|---|---|
| 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 |
| v0.28.55 | Floating reply drafts, now a setting under Experimental, open questions sit next to Reply again, a comment box that keeps unsent comments as Drafts, choose how your list looks: Minimal, Balanced or Detailed, update an older linked machine from this Inbox |
What's New in v0.28.67
TL;DR
- New: Drag threads to Priority, Archive or Quiet, or combine them
- New: Mention another thread in your reply
- New: Linear links show hover cards; add your key in Settings
- New: Agent icons made from the project name
- Changed: Pick any tag colour; turning a tint off keeps it
- Fixed: A linked computer's pictures, pages and files now open
- Fixed: Pull request cards say why they could not load
- Fixed: A review that can't load shows an error with Retry
v0.28.67 is a short Inbox release. You can now drag a thread row to sort it, hold it over another thread to combine the two, or drop it in your reply to mention it. Tags get a full colour picker, Linear links get hover cards, and a thread that lives on a linked computer now shows its pictures and opens its pages and nearby files. Two fixes protect you: the script in an HTML attachment can no longer move the Inbox to another thread, and a failed settings save can no longer empty config.json. The release has 30 PRs. One of them carries the Linear hover cards by @Raj1v, their first contribution.
Drag a thread to sort it, combine it or open it
On a computer, you can now pick up a thread row and drop it somewhere. While you carry it, three places show over the list: Priority at the top, and Archive and Quiet · Mark read at the bottom. A drop runs the same action as the row menu, with the same toast and Undo. Several picked rows move together, with one toast and one Undo. A place that cannot take the rows turns grey and says why, for example "Already in Priority" or "Already read", and a drop there changes nothing. Quiet still asks before it sets a question aside. If you cancel that warning, your picked rows stay picked.
Hold a row over the middle of another row for half a second to combine them. The row under the pointer reads "Combine with this thread". When you let go, the Combine dialog opens with both threads picked. It never combines on its own.
With Keep thread panel open on (in the list's ⋮ menu) and no thread open, the empty panel takes a dropped row and opens that thread.
Dragging needs a mouse, a trackpad or a pen with a fine pointer. Touch never drags: on a phone, the row's sheet and its swipe do the same things. An iPad with only its Pencil no longer announces rows as draggable, and connecting or removing a trackpad updates the rows at once.
Mention another thread in your reply
You can point your agent at another thread from the reply box. Drag a row onto the box, choose Mention in reply in the row's menu (also on a phone's row sheet), or paste a thread's link. The thread's title goes in as a token, and Backspace removes it whole. Several picked rows become several mentions. The sent message shows each mention as a link that opens the thread, and the mentioned thread itself does not change. Your agent gets each thread's title and id at the spot where you put it, and a short list of the threads you mentioned after your words.
Tag colours: any colour, and off keeps it
A tag's right-click menu in the sidebar now has two rows. Highlight rows is a checkbox that turns the tag's tint on or off at once. Color opens a picker in place, with quick swatches, your recent colours, a colour square, a hue strip and a Hex field. Turning a tag's highlight off keeps its colour, so turning it on again brings the same colour back. New tags go through all twelve swatches before any colour repeats.
A tinted row follows the colour you picked in every theme. On each built-in theme, its text is never harder to read than on that theme's plain row.
Linear hover cards
A linear.app/…/issue/ENG-123 link in the Inbox now shows a hover card, as GitHub and GitLab links do. It shows the issue's team, title, state, author, priority, project, labels, assignee, description, attached pull requests, the latest comment and Open in Linear. A bare ENG-123 in a message becomes a link when ENG is one of your workspace's team keys.
To see details, paste a Linear personal API key in Settings → Accounts → Linear. Cards work right after you save it, with no restart. The key is kept in a private file in Plannotator's data folder, never in config.json, and goes only to Linear. If LINEAR_API_KEY is set and no key is saved, the row says "Using LINEAR_API_KEY". Nothing is fetched until you hover or tap a card.
#3146, with the hover cards from #3063 by @Raj1v, closing #3120, which they also opened
Files on a linked computer open from here
When you look at a thread that lives on a linked computer, its files now work from this one:
- Markdown pictures show, and a link to a file next to it opens in the pane.
- An HTML page opens in its own tab, with its stylesheets and pictures. In the viewer beside the thread, the page's folder loads too, and a link to a page next to it opens in the pane. Large pages open as well.
- Open in shows only what works from here. The editors, Default app and Finder are not offered for another computer's file, so the "No attachment" errors are gone. Copy path copies that computer's path, and a picture still opens in a new tab.
Both computers need this version. An older linked computer still refuses these reads, and the picture stays broken as before.
Pull request cards say why they could not load
When the Inbox cannot get a pull or merge request from gh or glab, the card in a thread and the link hover card now say which problem it is, with one next step. Before, they could only say "The Inbox did not answer."
- gh isn't installed: a link to install it, and Try again.
- gh isn't signed in: the
gh auth login --hostname github.comcommand with Copy, and Try again. A refusedGH_TOKENis named. - gh didn't answer in 8 seconds, or GitHub asked for a short break (rate limited).
- gh can't see this pull request: Open on GitHub.
glab gets the same words for GitLab. A sign-in command only ever names github.com, gitlab.com, a host your CLI already knows, or your project's own host, never a look-alike host that a link named. Try again right after you sign in works at once.
Two safety fixes
- An HTML attachment's own script can no longer move the Inbox. Before, a script inside an attached HTML page could send the Inbox window to any thread with no click. Now only your own click on a link is followed. An HTML page from outside the project also gets no network in the viewer, as it already did when served by address. Annotate's HTML viewer gets the same protection. #3469
- A failed settings save can no longer empty
config.json. When the safe write (a temp file, then a rename) failed, Plannotator wrote straight intoconfig.json, and a full disk or a crash could leave it empty, so the next save lost every other setting. Now the old file is never touched: the save fails with the existing warning and your settings stay. On Windows, a save waits about two seconds for a program that holds the file.state.jsongets the same protection. #3473
Additional Changes
- The thread's title shows in its header bar, with its subject after it in a muted colour. A title cut short is a button: click or tap it to read the whole title. #3528
- Agent icons from the project name. Settings → Rows → Agent icons has a new choice, From the project name: a coloured tile with the project's letters, with the agent's mark as a small badge. It changes only agents with no face you picked.
plannotator inbox rows set agent-icons=projectsets it from a terminal. The default is unchanged. #3503 - The routine editor saves by itself. For people who turned on Routines: typing saves after a short pause, and the header says "Saving…", "Saved" or "Couldn't save · retrying". A new routine's draft is kept until it has a name and a prompt, even after a reload. Run once now saves first. The tip on the sidebar's and list's resize edges no longer covers a routine's name. #3558
- Docs: the README covers guided reviews and annotating a live site, shows the Workspaces picture in Sharing, and folds the long uninstall text. The HTML viewer's guide for host apps covers a host that loads the bridge by URL. #3554, #3524, #3531
- Code review shows an error with Retry when the diff cannot load, instead of a sample diff with no decision buttons. If the review server answered with an error, you can still send a note or close the review. #3573, for #940 reported by @digitalmaster, with diagnosis from @cschanhniem
- Groundwork with no visible change: page frame parts in
@plannotator/uifor host apps, and more of the thread pane work. #3540, #3562, #3528 - Test and CI upkeep: #3561, #3491, #3559, #3535, #3565
Install / Update
macOS / Linux:
curl -fsSL https://plannotator.ai/install.sh | bashWindows:
irm https://plannotator.ai/install.ps1 | iexClaude 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 userThen restart Claude Code. Inside Claude Code, run /plugin marketplace update plannotator, then open /plugin → Installed → plannotator → Update now.
Pi:
pi update npm:@plannotator/pi-extensionOpenCode: Re-run the install script above. It also clears the OpenCode 2 plugin cache.
What's Changed
- README: the Workspaces picture in Sharing; uninstall details fold away in #3524
- A failed settings save can no longer empty config.json in #3473
- CI: a docs-only PR skips the unit, DOM, package, smoke and Semgrep steps in #3491
- Inbox: Linear hover cards and the Linear key in Settings → Accounts (includes #3063 by @Raj1v) in #3146
- HTML attachments: a page's own script cannot move the Inbox; no network for pages from outside the project (port of #2511) in #3469
- HTML viewer docs: a host that loads the bridge by URL puts the load's key on the bridge's tag in #3531
- Pull request cards say why gh or glab could not answer in #3093
- Update lock tests: do not depend on how long the machine has been up in #3535
- Inbox: agent icons from the project name in #3503
- Open in: show only what works for a linked machine's file in #3536
- README: guided reviews and live site annotation in #3554
- Open a linked machine's HTML attachment in its own tab, with its folder in #3538
- Inbox: mention a thread in a reply (drag a row, row menu, pasted link) in #3526
- Inbox tag colors: a two-dimensional picker, and rows that follow the pick in #3553
- Inbox: the thread's title in its header bar, and thread pane groundwork (no visible change) in #3528
- UI frame: a reusable page screen for @plannotator/ui in #3540
- Inbox: drag threads to the list edges, onto another thread, and onto the empty panel in #3537
- Shared stream e2e (WebKit): wait for the takeover until the script runs out in #3559
- Inbox: a linked computer's Markdown pictures and the files next to it open here in #3557
- Inbox drags follow-ups: keep picks on a cancelled Quiet drop; drag help follows the device's pointers in #3560
- UI frame: follow-ups (author kind none, compared row name, README) in #3562
- Inbox: open a linked computer's large sibling page; document the window-only costs in #3563
- AGENTS.md: no AI attribution in commits, tags, release notes or PR bodies in #3565
- Inbox routines: the editor saves by itself and says so in #3558
- Inbox: internal groundwork, off in #3527
- Inbox: internal groundwork, off in #3556
- Inbox: internal groundwork, off in #3574
- Inbox: fixes from the release check: mention undo and editing, Linear key messages, small drag and tag colour fixes in #3576
- Run only what a PR's change can affect in PR CI in #3561
- Code review: show an error with Retry instead of the demo diff when the diff fails to load in #3573
New Contributors
Contributors
@Raj1v asked for Linear hover cards in the Inbox (#3120) and then built them (#3063): the card, its Linear states, and bare ENG-123 identifiers that become links. Their commit ships with its authorship kept inside #3146, which adds the Settings row for the Linear key. First contribution.
Thanks also to @digitalmaster, who reported the code review failure in #940, and @cschanhniem, who traced its cause there.
Full Changelog: v0.28.66...v0.28.67