Skip to main content
OpenBunny can process iMessage conversations on macOS using a Swift bridge daemon that reads from the Messages database.

​
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

1
Grant Full Disk Access
2
Go to System Settings > Privacy & Security > Full Disk Access and add your terminal app (Terminal, iTerm2, etc.).
3
Run the setup wizard
4
npm run setup
5
Select iMessage when prompted. The bridge daemon compiles and starts automatically.

​
How it works

The iMessage bridge is a Swift daemon (scripts/imessage-bridge.swift) that:
  1. Reads the macOS Messages database (~/Library/Messages/chat.db)
  2. Monitors for new messages
  3. Forwards them to the service over a local socket
The service processes these messages the same way as any other channel.
The bridge daemon must be running alongside the service. It starts automatically when the service starts if iMessage is configured.