Mock Visual replica of Message Relay
Back to projects
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.