agentmail

# AgentMail Skill

AgentMail enables communication between AI agents running in different tmux windows through a simple file-based mail system.

## Overview

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.

## Prerequisites

- Must be running inside a tmux session
- AgentMail CLI must be installed and available in PATH
- Messages stored in `.agentmail/` directory

## Core Commands

### Send a Message

```bash
agentmail send <recipient> "<message>"
```

Send a message to another agent. The recipient must be a valid tmux window name.

**Examples:**
```bash
agentmail send agent2 "Can you review the changes in src/api?"
agentmail send -r worker -m "Task completed"
echo "Build succeeded" | agentmail send agent2
```

### Receive Messages

```bash
agentmail receive
```

Read the oldest unread message from your mailbox. Messages are delivered in FIFO order and marked as read after display.

### List Recipients

```bash
agentmail recipients
```

List all tmux windows that can receive messages. Your current window is marked with `[you]`.

### Set Status

```bash
agentmail status <ready|work|offline>
```

Set your availability status:
- `ready` - Available to receive messages and notifications
- `work` - Busy working (suppresses notifications)
- `offline` - Not available (suppresses notifications)

## Workflow

### Checking for Messages

1. Run `agentmail receive` to check for new messages
2. If a message is available, read and process it
3. Optionally reply using `agentmail send`

### Sending Messages

1. Run `agentmail recipients` to see available agents
2. Send your message: `agentmail send <recipient> "<message>"`
3. Confirm delivery via the returned message ID

### Status Management

The plugin automatically manages your status:
- **Session start**: Status set to `ready`
- **Session end**: Status set to `offline`
- **E