All agents

Pi

The extension gives Pi the Inbox tool and plan review. Your reply arrives once Pi is idle.

Native plug-in · Inbox built in and your reply wakes it

Set it up

  1. Install Plannotator.

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

    You should see The installer’s PI USERS part prints the extension command.

  2. Add the extension. It needs Pi 0.79.1 or newer.

    pi install npm:@plannotator/pi-extension
  3. Open the Inbox. It connects the agents it finds on this computer.

    plannotator inbox

    You should see The Inbox opens in your browser. Settings → Agents lists Pi through Plannotator’s extension.

  4. plannotator inbox turned the tool on when it found the extension. Type /reload in Pi.

    /reload

    You should see Pi has a plannotator_inbox tool.

Other ways

On Windows

Install Plannotator from PowerShell. The other steps are the same.

irm https://plannotator.ai/install.ps1 | iex

Turn the tool on without the Inbox

Merge this into your Plannotator config. Then /reload in Pi.

~/.plannotator/config.json
{ "inboxTool": { "pi": true } }

Oh My Pi

Install the extension as an OMP plugin. Then restart OMP.

omp plugin install @plannotator/pi-extension

Through MCP

Pi 0.99 or newer. Replies don’t wake Pi this way.

pi mcp add plannotator-inbox -- plannotator inbox mcp

Check it works

Paste this into Pi.

Send me a test question in the Plannotator Inbox, and read my answer when I tell you I sent it.

You should see A question arrives in the Inbox. Answer it and press Send. The thread reads Delivered to Pi and Pi goes on with your answer.

Troubleshooting

Pi has no plannotator_inbox tool

Run plannotator inbox once: it turns the tool on when it finds the extension. If you turned the tool off yourself, turn it on in Settings → Agents. Then /reload in Pi (/restart in Oh My Pi).

Settings → Agents says Pi needs a reload

Update the extension and reload Pi.

pi update --extensions
The tool says to install Plannotator

It found no plannotator binary. Install Plannotator or set PLANNOTATOR_BIN to its path.

No tool in print or JSON mode

That is expected. Nothing could bring a reply back there, so the tool stays inactive.

A Pi session the Inbox started says Pi’s turn ended with an error

Pi’s provider refused the turn, for example a model your login doesn’t allow or an expired login. The note gives Pi’s own words. Fix that in Pi and reply again.

The switches in Settings → Agents are greyed out

PLANNOTATOR_INBOX_TOOL is set in your shell. It decides for every agent until you unset it.

The Inbox doesn’t open

Read ~/.plannotator/inbox/inbox.log. Stop a stuck Inbox process and run plannotator inbox again.

What works

  • Inbox tool Built in, off at first
  • Reply wakes it Wakes it
  • Start from Inbox Yes
  • Permission cards No
  • Plan review Yes
  • Code review Yes
  • Annotate Files and last reply
  • Ask this session Yes
  • Ask this session doesn’t work in remote mode.
  • Starting Pi from the Inbox is macOS and Linux for now.

Examples

  • Start Pi with --plan and review its plan in Plannotator.
  • Pick New Pi session in the Inbox to start one from there.

Every agent Full Pi guide

Built by

With contributions from