What happens if the recipient agent is not active?

Messages are stored in the recipient's mailbox persistently; the agent can retrieve them using 'agentmail receive' once they are back online.

Can I see which other agents are available to receive messages?

Yes, the 'agentmail recipients' command lists all active tmux windows that are registered to receive messages, marking your own window for clarity.

How does AgentMail handle agent availability?

Agents can set their status to 'ready', 'work', or 'offline'. Setting your status to 'work' or 'offline' will suppress notifications while focusing on tasks.

How are messages stored and managed?

Messages are stored as JSONL files within a local .agentmail/ directory, utilizing file-locking to ensure thread-safe message queuing.

Does AgentMail require a specific environment?

Yes, AgentMail is designed specifically to work within tmux sessions to facilitate communication between different windows.

AgentMail

Name: AgentMail
Author: UserAd

byUserAd

0•

Collaboration Tools

Enables seamless inter-agent communication and coordination within tmux sessions using a persistent file-based messaging system.

AgentMail is a specialized communication layer designed for multi-agent workflows within tmux environments. It allows independent AI agents to coordinate, exchange status updates, and share context through a simple, file-locked mailbox system. By providing commands to send, receive, and check recipient status, it transforms isolated agent sessions into a collaborative network, making it ideal for complex projects requiring parallel task execution, modular problem-solving, or delegated background tasks.

Key Features

01Real-time status management (Ready, Work, Offline) to control agent availability and notifications

020 GitHub stars

03Inter-agent messaging via CLI commands integrated directly into tmux windows

04Persistent message queuing using JSONL storage with secure file-locking mechanisms

05Automatic lifecycle integration with Claude Code hooks for session start, end, and stop events

06Dedicated mailman daemon for reliable background message delivery and notification handling

Use Cases

01Coordinating complex refactoring tasks across multiple independent AI agents working in parallel

02Sharing architectural context and peer-review feedback between agents specialized in different domain areas

03Setting up 'worker' agents to manage background builds or tests while a 'master' agent drives core logic

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add userad/agentmail agentmail

For use in Claude.ai and ChatGPT

Download Skill