Stats
Actions
Tags
From agentmail
Inter-agent communication for tmux sessions. Send and receive messages between AI agents.
How this skill is triggered — by the user, by Claude, or both
Slash command
/agentmail:agentmailThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
AgentMail enables communication between AI agents running in different tmux windows through a simple file-based mail system.
AgentMail enables communication between AI agents running in different tmux windows through a simple file-based mail system.
AgentMail is a CLI tool for inter-agent communication within tmux sessions. Messages are stored in .agentmail/mailboxes/ as JSONL files, providing persistent, file-locked message queues for each agent.
.agentmail/ directoryagentmail send <recipient> "<message>"
Send a message to another agent. The recipient must be a valid tmux window name.
Examples:
agentmail send agent2 "Can you review the changes in src/api?"
agentmail send -r worker -m "Task completed"
echo "Build succeeded" | agentmail send agent2
agentmail receive
Read the oldest unread message from your mailbox. Messages are delivered in FIFO order and marked as read after display.
agentmail recipients
List all tmux windows that can receive messages. Your current window is marked with [you].
agentmail status <ready|work|offline>
Set your availability status:
ready - Available to receive messages and notificationswork - Busy working (suppresses notifications)offline - Not available (suppresses notifications)agentmail receive to check for new messagesagentmail sendagentmail recipients to see available agentsagentmail send <recipient> "<message>"The plugin automatically manages your status:
readyofflineready, checks for new messagesMessages include:
agentmail receive to stay informedwork when focusing on complex tasksThis plugin integrates with Claude Code hooks:
ready and runs onboardingofflineready and checks for new messagesThe hooks ensure agents are properly registered and can receive notifications from the mailman daemon.
AgentMail requires tmux. Start a tmux session first.
The recipient window doesn't exist. Check available windows with agentmail recipients.
Your mailbox is empty. Other agents haven't sent you messages yet.
Ensure the mailman daemon is running: agentmail mailman --daemon
npx claudepluginhub userad/agentmail --plugin agentmailEnables communication between coding agent sessions via msg CLI: register in tmux panes, send/reply messages, check inbox, list agents/threads.
Cross-agent messaging via SQLite for Claude Code, Codex, Gemini CLI, Copilot CLI, and other agents. No daemon or network needed.
Agent-to-agent messaging bus for Claude Code. Sends messages between local sessions, delegates tasks, fans-out work, and coordinates concurrent agents on the same machine.