git:20260331.eba3989 to git:20260428.8527320

4 added, 0 removed. Audit A to A.

---

name: imessage-send

description: Send a message by name or number

---

Send a message using imessage-tools.

```

imessage-tools send $ARGUMENTS

```

The CLI handles:

- Contact name resolution (e.g. "John" -> phone number via macOS Contacts)

- Auto-detecting the correct service (iMessage, RCS, SMS) from chat history

- Service override with --sms, --rcs, or --imessage flags

- Sending to multiple contacts at once (1:many, comma-separated names)

- Sending to existing group chats by name (--group flag)

+ - Rich link previews via --preview (routes through Messages.app compose so

+ URLs unfurl into og:title/og:image cards; briefly steals focus for ~6s

+ per send)

Examples of how the user might invoke this:

- `/imessage-send "Jane Doe" "Hey what's up?"` (1:1 send)

- `/imessage-send "John Smith" "Let's grab lunch"` (1:1 send)

- `/imessage-send +15551234567 "Hello!"` (1:1 by number)

- `/imessage-send "Jane Doe" "Hello!" --rcs` (1:1 with service override)

+ - `/imessage-send "Jane Doe" "https://example.com/post" --preview` (URL with rich preview)

- `/imessage-send "Jane, John, Bob" "Meeting at 3"` (1:many individual sends)

- `/imessage-send --group "Work Chat" "Hello team!"` (existing group chat)

Parse $ARGUMENTS to extract the recipient and message, then run the command.