agent-mail

name	agent-mail
description	Inter-agent communication for multi-agent workflows. Use when multiple agents need to coordinate, share information, or reserve resources.

Agent Mail System

Communication system for coordinating multiple agents.

Overview

Agent mail enables:

• Message passing between agents
• File reservation to prevent conflicts
• Session tracking across agents
• Thread-based conversations

Session Management

Start Agent Session

Register agent and get inbox:

# Initialize session
curl -X POST http://localhost:3847/api/session/start \
  -H "Content-Type: application/json" \
  -d '{
    "project_path": "/path/to/project",
    "program": "claude-code",
    "model": "opus-4",
    "agent_name": "agent-1",
    "task_description": "Working on auth module"
  }'

List Agents

curl http://localhost:3847/api/agents?project_path=/path/to/project

Agent Info

curl http://localhost:3847/api/agents/agent-1?project_path=/path/to/project

Messaging

Send Message

curl -X POST http://localhost:3847/api/mail/send \
  -H "Content-Type: application/json" \
  -d '{
    "project_path": "/path/to/project",
    "sender_name": "agent-1",
    "to": ["agent-2"],
    "subject": "Auth module complete",
    "body_md": "## Summary\nAuth implementation is done.\n\n## Files changed\n- src/auth/*",
    "importance": "normal",
    "ack_required": false
  }'

Check Inbox

curl "http://localhost:3847/api/mail/inbox?project_path=/path/to/project&agent_name=agent-1"