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

> Manage the iMessage channel on macOS.

## Setup

Interactive setup that configures iMessage environment variables and verifies Full Disk Access.

```bash theme={null}
openbunny imessage setup
```

## Check access

Verify that Full Disk Access is granted for reading the Messages database.

```bash theme={null}
openbunny imessage check-access
```

## List chats

Show iMessage chats from the macOS Messages database.

```bash theme={null}
openbunny imessage list
```

## Whitelist

Control which iMessage conversations are processed. Entries can be phone numbers, email addresses, or chat IDs.

```bash theme={null}
openbunny imessage whitelist                          # Show current policy
openbunny imessage whitelist add +15551234567          # Add an entry
openbunny imessage whitelist add user@example.com      # Add by email
openbunny imessage whitelist remove +15551234567       # Remove an entry
openbunny imessage whitelist clear                     # Clear all entries
openbunny imessage whitelist allow-all on              # Listen to all chats
```