agentmail

Send and receive file-based messages between tmux agents.

Updated Jan 29, 2026
One-click install
npx skills add https://github.com/NovaAI-innovation/Infinite-Agency --skill agentmail-novaai-innovation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agentmail
Source: https://github.com/NovaAI-innovation/Infinite-Agency/tree/main/.qwen/skills/agentmail
Command: npx skills add https://github.com/NovaAI-innovation/Infinite-Agency --skill agentmail-novaai-innovation

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enables seamless communication between AI agents operating within different tmux sessions, overcoming the isolation of individual terminals.

Core Features & Use Cases

  • File-based Messaging: Agents send and receive messages via a persistent, file-locked mailbox system.
  • Tmux Integration: Leverages tmux window names for recipient identification, ensuring messages reach the correct agent.
  • Status Management: Agents can signal their availability (ready, work, offline) to manage communication flow.
  • Use Case: An agent working on code generation can notify a documentation agent to update the docs once a feature is complete, all through simple command-line messages.

Quick Start

Send a message to agent2 saying "Can you review the changes in src/api?".

Frequently Asked Questions about agentmail

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I facilitate inter-agent communication within tmux sessions?

Inter-agent communication within tmux sessions is facilitated by using a file-based messaging system that sends and receives messages via a persistent, file-locked mailbox. Agents are identified by their tmux window names to ensure correct routing.

How does file-based messaging work for AI agents in different terminals?

File-based messaging for AI agents works by using a persistent, file-locked mailbox system. This overcomes terminal isolation by allowing agents in different sessions to send and receive messages directly through command-line inputs.

Can I manage agent availability status during a tmux session lifecycle?

You can manage agent availability status by signaling states like ready, work, or offline. This integrates with Claude Code hooks to automate status management during tmux session lifecycle events, controlling communication flow.

Does inter-agent messaging require specific dependencies to work with tmux?

Inter-agent messaging requires no external dependencies. It leverages existing tmux window names for recipient identification and integrates with Claude Code hooks for automated status management.

What is the best way to notify another agent in a different tmux window?

The best way to notify another agent is by sending a command-line message to the recipient identified by its tmux window name. The file-based system handles the delivery, allowing an agent to notify another to update docs or review code.

Why should I use a file-based mailbox system for terminal agent collaboration?

A file-based mailbox system ensures persistent and file-locked message delivery between agents. It overcomes the isolation of individual terminals, enabling seamless collaboration for tasks like code generation and documentation updates.