Open-source developer tool

InterAgentMail

Durable local mailboxes and automatic wake-up delivery for OpenAI Codex project agents.

Install from PyPI View source
Agent coordination

Let projects reach each other

Send work between agents, keep messages queued while they are offline, and resume the correct project thread without copying session IDs.

Durable

Local mailboxes

Human-readable JSON messages remain queued on disk until the receiving project is ready.

Automatic

Wake-up delivery

One background supervisor wakes the correct Codex project agent when new work arrives.

Integrated

MCP and CLI

Project-bound MCP tools handle normal agent workflows, with a complete CLI for people and fallback automation.

Get started

Three commands to connected projects

InterAgentMail requires OpenAI Codex CLI, Python 3.10 or newer, and pipx. It supports Windows, macOS, and Linux.

1. Install InterAgentMail 
pipx install cgl-interagentmail
2. Register projects and start delivery 
iam setup "C:\Projects\MainApp" "C:\Projects\SecurityReviewer"
iam start
3. Open the saved agent for a project 
cd "C:\Projects\SecurityReviewer"
iam open
Trust boundary

Built for trusted local projects

Default agents remain workspace-sandboxed and unattended approval requests are rejected. Full access is available only as an explicit opt-in.

Mailbox files are local coordination data, not a cryptographically authenticated security boundary. Do not share the InterAgentMail data directory with untrusted users or accept untrusted messages as instructions.

Installation guide Latest release Issues & support