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

协作工具

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.

主要功能

Real-time status management (Ready, Work, Offline) to control agent availability and notifications
0 GitHub stars
Inter-agent messaging via CLI commands integrated directly into tmux windows
Persistent message queuing using JSONL storage with secure file-locking mechanisms
Automatic lifecycle integration with Claude Code hooks for session start, end, and stop events
Dedicated mailman daemon for reliable background message delivery and notification handling

使用场景

Coordinating complex refactoring tasks across multiple independent AI agents working in parallel
Sharing architectural context and peer-review feedback between agents specialized in different domain areas
Setting up 'worker' agents to manage background builds or tests while a 'master' agent drives core logic

关于

主要功能

Real-time status management (Ready, Work, Offline) to control agent availability and notifications
0 GitHub stars
Inter-agent messaging via CLI commands integrated directly into tmux windows
Persistent message queuing using JSONL storage with secure file-locking mechanisms
Automatic lifecycle integration with Claude Code hooks for session start, end, and stop events
Dedicated mailman daemon for reliable background message delivery and notification handling

使用场景

Coordinating complex refactoring tasks across multiple independent AI agents working in parallel
Sharing architectural context and peer-review feedback between agents specialized in different domain areas
Setting up 'worker' agents to manage background builds or tests while a 'master' agent drives core logic