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
-
Install Plannotator.
curl -fsSL https://plannotator.ai/install.sh | bashYou should see The installer’s
PI USERSpart prints the extension command. -
Add the extension. It needs Pi 0.79.1 or newer.
pi install npm:@plannotator/pi-extension -
Open the Inbox. It connects the agents it finds on this computer.
plannotator inboxYou should see The Inbox opens in your browser. Settings → Agents lists Pi through
Plannotator’s extension. -
plannotator inboxturned the tool on when it found the extension. Type/reloadin Pi./reloadYou should see Pi has a
plannotator_inboxtool.
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.
{ "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_inboxtool -
Run
plannotator inboxonce: it turns the tool on when it finds the extension. If you turned the tool off yourself, turn it on in Settings → Agents. Then/reloadin Pi (/restartin 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
plannotatorbinary. Install Plannotator or setPLANNOTATOR_BINto 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_TOOLis 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 runplannotator inboxagain.
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
--planand review its plan in Plannotator. - Pick New Pi session in the Inbox to start one from there.