pi-intercom
Pi coding agent extension for direct 1:1 messaging and coordination between pi sessions on the same machine.
At a Glance
pi-intercom extension for direct 1:1 messaging between pi sessions on the same machine, released under the MIT License.
Engagement
Available On
Listed Nov 2026
About pi-intercom
Pi Intercom is an extension for the pi coding agent that lets separate pi sessions on one machine exchange direct messages. Users can send context, findings, or requests from one session to another, or let agents coordinate with each other. It is MIT-licensed and the latest listed release is v0.18.1.
What It Is
Pi Intercom connects each intercom-enabled pi session to a small local broker over local IPC (Unix sockets on macOS/Linux, a named pipe on Windows). The broker tracks connected sessions and routes messages to a target chosen by name or session ID. The extension provides an intercom tool for agents and an overlay UI opened with Alt+M or /intercom. Incoming messages render inline in the recipient session and are stored in Pi session history.
How Messaging Works
The tool supports listing sessions, send (fire-and-forget), ask (blocks until the recipient replies), reply, pending, cancel, status, and handover. Messages can carry file, snippet, or context attachments. A planner-worker pattern is documented: a planner delegates with send, and a worker uses ask to get clarifications without losing context. Config options control confirmation before sending, whether inbound messages trigger a turn, and how busy sessions receive messages.
Handover and Subagent Escalation
The /handover command has the current model summarize a session, covering next task, decisions, relevant files, and open questions, and sends it to another session or a new Herdr project pane for review before sending. When used with pi-subagents, delegated child agents get a contact_supervisor tool with reasons for decisions, structured interviews, or progress updates.
Scripting and Limits
A pi-intercom CLI can list sessions and send or ask from scripts, and can relay messages across machines over SSH. Documented limitations include same-machine operation for the broker, no dedicated intercom log beyond Pi session history, and only connected sessions appearing in the roster.
Community Discussions
Be the first to start a conversation about pi-intercom
Share your experience with pi-intercom, ask questions, or help others learn from your insights.
Pricing
Open Source (MIT)
pi-intercom extension for direct 1:1 messaging between pi sessions on the same machine, released under the MIT License.
- MIT License
- Direct 1:1 messaging between pi sessions on the same machine
- Local broker using Unix socket or named pipe
- Install via `pi install npm:pi-intercom`
- Same machine only; no network support
Capabilities
Key Features
- Direct 1:1 messaging between local pi sessions
- Alt+M and /intercom session overlay
- send, ask, reply, pending, cancel and status actions
- Message attachments (file, snippet, context)
- Session handover with generated summary
- contact_supervisor tool for pi-subagents children
- Local broker with mailbox for disconnected sessions
- Configurable inbound trigger and busy delivery
- Routing pools and scopes
- Extension channels and outbox API
- pi-intercom CLI for scripting
- Cross-machine send over SSH
- Bundled pi-intercom skill
