johnlindquist/claude/agent-mail

# 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"

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"

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