---

name: imessage-sender description: Send iMessages with text, files, and links. Use when "send to [name]", "iMessage this to", "text [name]", "share with [name] via iMessage", "ping [name]", "message [name]". allowed-tools: Read, Bash, Glob, AskUserQuestion

iMessage Sender

Send iMessages via the imsg CLI. Supports text, file attachments, and URLs.

Workflow

Step 1: Parse the Request

Extract from the user's message:

• Recipient: Name or phone number
• Message content: Text to send
• Attachments: Files to include (if any)
• URLs: Links to share (included in message text)

Step 2: Resolve Recipient

1. Read contacts config:

   Copycat ~/.config/imessage-contacts.yaml
   

2. Look up the recipient name (case-insensitive match)

3. If contact not found:

   • Ask the user for the phone number using AskUserQuestion
   • Format: "+1XXXXXXXXXX" (E.164 format, US numbers need +1 prefix)
   • Offer to add the contact to the config for future use

Step 3: Prepare Message

Text only:

Copyimsg send --to "+1XXXXXXXXXX" --text "Message here" --service imessage

With file attachment:

Copyimsg send --to "+1XXXXXXXXXX" --text "Here's the file" --file "/path/to/file.pdf" --service imessage

With URL (include in text body):

Copyimsg send --to "+1XXXXXXXXXX" --text "Check this out: https://example.com" --service imessage

Multiple files: Send as separate messages (imsg handles one file per message)

Step 4: Execute and Confirm

1. Run the imsg send command
2. Report success or failure to the user
3. If failed, explain the error and suggest fixes

Common Errors

Examples

"text myself hello" → Look up "myself" in contacts → Send "hello"

"send to taki: check this out https://example.com" → Look up "taki" → Send message with URL

"share this PDF with mom" → Look up "mom" → Send current file as attachment

"iMessage +14155551234: running late" → Use number directly → Send message

Notes

• URLs in the message text render as rich link previews in iMessage
• The --service imessage flag ensures iMessage; imsg falls back to SMS if needed
• This skill is send-only; it does not read message history