Message Relay

message-relay — node

$ relay-start
ℹ Starting message-relay service...
✓ Server listening on port 3000
✓ iMessage integration ready
✓ Health endpoint: http://localhost:3000/health
 
# Send a test message
$ curl -X POST http://localhost:3000/webhook \
 -H "Content-Type: application/json" \
 -d '{"message": "Hello!", "phoneNumbers": ["+1234567890"]}'
 
{
 "success": true,
 "message": "Message sent successfully",
 "recipients": 1,
 "phoneNumbers": ["+1234567890"]
}

message-relay — health check

$ relay-status
 
{
 "status": "healthy",
 "timestamp": "2025-02-17T14:30:00.000Z"
}

Features

📡

Webhook Endpoint

Accepts POST requests with message payloads and delivers them via iMessage using macOS AppleScript.

👥

Group Messaging

Send to multiple recipients simultaneously. Supports group chat keywords to target existing conversations.

🏥

Health Monitoring

Built-in health check endpoint with graceful shutdown and proper signal handling.

🚀

Auto-Start

Configure as a launchd service to start automatically on boot with helpful shell aliases.