Plannotator Inbox

An inbox to stay on top of your agents

Coding agents now work for hours. Over a run they have questions. They hit blockers. They produce plans and prototypes and diffs you need to review. The Inbox is where all of that arrives while they keep working. You read it like mail and answer when you get to it. Reviewing and annotating is the native Plannotator experience. The agent picks up your answer and goes on.

Local. Claude Code and Pi and OpenCode and any MCP agent. Open source.

Set up the Inbox

Why not the agent's own window

The agent's window is for the run you are watching. Long runs are the ones you are not watching. With several agents going you are not sitting in any of their windows. Their questions and blockers and reviews need somewhere to land that is not a scrollback.

The Inbox is that place. Every agent writes to it. Each item is a thread with its context attached. You open it when you are ready. You answer or annotate once. The agent continues from there.

How it works

01

An agent writes to the Inbox while it works.

A question with options. A blocker. A plan or a prototype or a diff to review.

02

You answer in the Inbox.

Pick an option. Annotate the file with Plannotator. Send.

03

The agent gets the answer.

It arrives as the session's next turn. The thread shows "Delivered to Claude Code".

What arrives during one run

01

The design doc

The agent sends you its design doc and keeps working. The doc opens next to the thread with its diagrams drawn. You comment on the lines you care about. Nothing reaches the agent until you send.

If the agent edits the doc after sending it, the Inbox says so, and “View sent version” opens the version it sent.

You are somewhere else while this happens. The agents keep working. The Inbox tells you when something needs you.

02

A prototype

The agent sends you the prototype. It opens next to the thread or at full screen. You pin comments on the parts to change. The comments go with your next send.

Markdown and HTML and Mermaid and Graphviz. Plannotator's annotation tools.

The prototype next to its thread with four comments pinned and a fifth being written

03

The guided review

At the end of the run the agent sends a guided review. The change is split into sections in reading order. Each section has its diff and a short summary. Every file is checked against the real diff. You read the whole change in one sitting.

A full review surface

A question can offer pictures as its choices. You pick the variant you want by looking at it. Documents and prototypes and diagrams and images and videos and code all open at full screen. You can comment on every one of them and draw on images. It is Plannotator's annotation and review in every file.

Connections

Plannotator's Claude Code mod and Pi extension and OpenCode plugin write to the Inbox on their own and wake the agent when you send. Claude Code has the Inbox tool on by default; for Pi and OpenCode, turn it on in the Inbox's Settings (it applies from the next Pi session or OpenCode start).

Claude Code
Pi
OpenCode

Any other agent connects to the Inbox as a local MCP server. The Inbox shows the exact step for Codex and Cursor and VS Code and Gemini CLI and Zed and Goose and Amp and Cline.

codex mcp add plannotator-inbox -- plannotator inbox mcp

Local

  • Listens on 127.0.0.1. Opens in your browser.
  • Threads and answers are files under ~/.plannotator.
  • Part of Plannotator. MIT or Apache 2.0.

An excellent mobile experience

The Inbox works on your phone. Open it through Tailscale and read and answer and review from anywhere. Question cards and documents and prototypes and your comments all fit the small screen.

Want to see the version of this that helps your team? Sign up for Workspaces.

An Async Surface for Long-Running Agents

Install

Copy the prompt and paste it into your agent. It installs Plannotator and connects the Inbox.

Or install it yourself, then run plannotator inbox.

curl -fsSL https://plannotator.ai/install.sh | bash

Built by

With contributions from