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#

bash

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

Multimedia Messages#

bash

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

bash

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

bash

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

With screenshot#

bash

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

bash

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

Options Reference#

OptionDescriptionExample-t, --textText message-t "Hello"``-i, --imageImage file-i photo.jpg``-v, --videoVideo file-v clip.mp4``-a, --audioAudio file-a voice.m4a``-f, --fileAny file-f doc.pdf``-u, --urlURL with preview-u "https://..."``-r, --recipientOverride recipient-r "other@icloud.com"``-h, --helpShow help-h

Script Reference#

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