Prerequisites
- macOS (iMessage is not available on other platforms)
- Full Disk Access granted to the terminal running the service
- Messages app configured with your Apple ID
Setup
How it works
The iMessage bridge is a Swift daemon (scripts/imessage-bridge.swift) that:
- Reads the macOS Messages database (
~/Library/Messages/chat.db) - Monitors for new messages
- Forwards them to the service over a local socket
The bridge daemon must be running alongside the service. It starts automatically when the service starts if iMessage is configured.