> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openbunny.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# iMessage

> Connect to iMessage on macOS using the native bridge daemon.

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

<Steps>
  ### Grant Full Disk Access

  Go to **System Settings > Privacy & Security > Full Disk Access** and add your terminal app (Terminal, iTerm2, etc.).

  ### Run the setup wizard

  ```bash theme={null}
  npm run setup
  ```

  Select iMessage when prompted. The bridge daemon compiles and starts automatically.
</Steps>

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

<Note>
  The bridge daemon must be running alongside the service. It starts automatically when the service starts if iMessage is configured.
</Note>