# imsg

Linux CLI for accessing an iPhone over Bluetooth — read and send messages
(SMS, MMS, iMessage), browse contacts, and stream live notifications.
Uses MAP (Message Access Profile) and PBAP (Phone Book Access Profile).
No Mac required.

> **Early development** — not yet ready for general use.

## Features

- List, read, and send messages (SMS, MMS, iMessage)
- Browse and search contacts / phonebook
- Reverse lookup a phone number to a contact name
- Stream live message notification events (`watch`)

## Usage

```bash
imsg config set-device <IPHONE_MAC>

imsg list
imsg list --unread
imsg get <handle>
imsg send <number> "hello"

imsg contacts --list
imsg contacts --lookup "+14085551234"

imsg watch
```

## Status

Core commands work. Persistence, local encryption, and full notification
support are in progress.

## License

MIT
