Menu
Inter-agent communication for multi-agent workflows. Use when multiple agents need to coordinate, share information, or reserve resources.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Always search before starting any work across all coding agent session histories (Claude Code, Codex, Cursor, Gemini CLI, Aider, ChatGPT) to find whatever we've discussed before.
Spawn 5 Opus subagents with randomly-generated distinct personas to debate a problem from multiple angles. Use when exploring UX decisions, architecture choices, or any decision that benefits from diverse perspectives arguing creatively.
Configure Karabiner-Elements keyboard remapping using Goku EDN syntax. Use when creating keybindings, layers, simlayers, app-specific shortcuts, or modifying karabiner.edn.
Bundle code context for AI. ALWAYS use --limit 49k unless user explicitly requests otherwise. Use for creating shareable code bundles and preparing context for LLMs.
Build Raycast extensions with React and TypeScript. Use when the user asks to create a Raycast extension, command, or tool.
Create new Agent Skills for Claude Code. Use when user wants to create a skill, add a new capability, document a CLI workflow, or asks how skills work.
| name | agent-mail |
| description | Inter-agent communication for multi-agent workflows. Use when multiple agents need to coordinate, share information, or reserve resources. |
Communication system for coordinating multiple agents.
Agent mail enables:
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"
}'
curl http://localhost:3847/api/agents?project_path=/path/to/project
curl http://localhost:3847/api/agents/agent-1?project_path=/path/to/project
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
}'
curl "http://localhost:3847/api/mail/inbox?project_path=/path/to/project&agent_name=agent-1"
curl -X POST http://localhost:3847/api/mail/reply \
-H "Content-Type: application/json" \
-d '{
"project_path": "/path/to/project",
"message_id": 123,
"sender_name": "agent-2",
"body_md": "Thanks! I'\''ll start on the API integration."
}'
curl -X POST http://localhost:3847/api/mail/ack \
-H "Content-Type: application/json" \
-d '{
"project_path": "/path/to/project",
"agent_name": "agent-2",
"message_id": 123
}'
curl "http://localhost:3847/api/mail/search?project_path=/path/to/project&query=authentication"
Prevent conflicts when multiple agents edit files.
curl -X POST http://localhost:3847/api/files/reserve \
-H "Content-Type: application/json" \
-d '{
"project_path": "/path/to/project",
"agent_name": "agent-1",
"paths": ["src/auth/*.ts", "src/config.ts"],
"exclusive": true,
"reason": "Implementing authentication",
"ttl_seconds": 3600
}'
curl "http://localhost:3847/api/files/reservations?project_path=/path/to/project"
curl -X POST http://localhost:3847/api/files/release \
-H "Content-Type: application/json" \
-d '{
"project_path": "/path/to/project",
"agent_name": "agent-1",
"paths": ["src/auth/*.ts"]
}'
curl "http://localhost:3847/api/mail/thread/THREAD_ID/summary?project_path=/path/to/project"
Threads are automatically created when replying to messages.
Agent 1 completes task:
1. Reserve output files
2. Complete work
3. Send message to Agent 2 with handoff details
4. Release file reservations
Agent 2 receives:
1. Get inbox
2. Reserve input files
3. Continue work
4. Acknowledge receipt
Coordinator:
1. Reserve coordination files
2. Send tasks to agents
3. Wait for completion messages
4. Merge results
Workers:
1. Reserve assigned files
2. Complete task
3. Send completion message
4. Release files
Author:
1. Complete code
2. Send review request to reviewer agents
3. Wait for feedback
Reviewers:
1. Get inbox
2. Review code (read-only, no reservation needed)
3. Send feedback message
curl http://localhost:3847/api/health
| Level | Use Case |
|---|---|
low | FYI, status updates |
normal | Standard communication |
high | Needs attention soon |
urgent | Blocking, needs immediate response |
ack_required