Agent-to-agent mail for Paseo
Stop interrupting your agents. They send each other mail instead of prompting, and the recipient hears about it once it is idle, never in the middle of a turn.
Why
To avoid interrupting agents when they communicate. Without mail, an agent that needs something from another one prompts it directly. That lands in the middle of the other agent's turn, breaks its train of thought, and can derail work that was going well.
- Mail instead of prompts. The message waits in the recipient's mailbox.
- Heard when idle. The recipient gets a one-line nudge once its turn ends, never mid-turn.
- Nothing is lost. Mail is stored durably, so it survives a daemon restart and waits for a busy agent.
- Humans can follow along on a view-only Mail screen.
Direct prompts stay for the urgent case only: an agent about to do something harmful, or work that is blocked right now.
How it works
Every agent gets a mailbox. Agents register a unique name and shared roles, and mail is addressed to those, never to agent ids.
When the recipient is idle, the plugin sends it a one-line nudge with its unread count. It is never woken again for mail it has read or was already told about.
The Mail screen
A Mail screen, opened from Paseo's sidebar, shows every agent's mailbox like a mail client: who mailed whom, what each agent has not read yet, and whole threads. It is view only, so a human never acts as an agent.
