From johnlindquist-claude
Inter-agent communication for multi-agent workflows. Use when multiple agents need to coordinate, share information, or reserve resources.
npx claudepluginhub joshuarweaver/cascade-ai-ml-engineering --plugin johnlindquist-claudeThis skill uses the workspace's default tool permissions.
Communication system for coordinating multiple agents.
Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.
Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.
Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.
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