iMessage Notification Skill

Send iMessage notifications to your iPhone using Mac's Messages app via AppleScript.

Features: Text, Images, Videos, Audio, Files, URLs (with preview)

Prerequisites

• Mac mini (or Mac) with Messages app open and signed in
• iPhone signed into the same Apple ID (iMessage)
• Apple ID: fan.xia@qq.com

Quick Usage

Simple Text Message

./scripts/send-imessage.sh "Your notification message"
# Or shortcut:
~/Document/code/clawd/notify "Hello!"

Multimedia Messages

# Text only
./scripts/send-imessage-media.sh -t "Task completed!"

# Send image
./scripts/send-imessage-media.sh -i ~/Desktop/screenshot.png

# Send video
./scripts/send-imessage-media.sh -v ~/Movies/clip.mp4

# Send audio/voice
./scripts/send-imessage-media.sh -a ~/Desktop/recording.m4a

# Send any file
./scripts/send-imessage-media.sh -f ~/Documents/report.pdf

# Send URL (displays preview)
./scripts/send-imessage-media.sh -u "https://www.apple.com"

# Combined: Text + Image
./scripts/send-imessage-media.sh -t "Check this:" -i ~/Desktop/chart.png

# Combined: Text + Link
./scripts/send-imessage-media.sh -t "Found this:" -u "https://example.com"

Shortcuts

# Quick text
cd ~/Document/code/clawd && ./notify "Hello"

# Quick multimedia
cd ~/Document/code/clawd && ./notify-media -t "Done!" -i result.png

From Clawdbot Tasks

Simple notification

# At the end of a task:
~/Document/code/clawd/notify "🎉 Build finished!"

With screenshot

# Take screenshot and send
screencapture -i ~/Desktop/result.png
~/Document/code/clawd/notify-media -t "Error occurred:" -i ~/Desktop/result.png

Task completion with file

# Generate report and notify
./generate-report.sh
~/Document/code/clawd/notify-media -t "Report ready:" -f ~/output/report.pdf

Options Reference

Script Reference

• scripts/send-imessage.sh - Simple text messages
• scripts/send-imessage-media.sh - Full multimedia support