imessage

iMessage 集成

使用 macOS 上的 imsg CLI 工具发送和读取 iMessage/SMS。

设置

1. 构建 imsg CLI

克隆并构建该工具：

git clone https://github.com/letta-ai/imsg.git ~/repos/imsg
cd ~/repos/imsg
swift build -c release

二进制文件位于 ~/repos/imsg/.build/release/imsg（如果 ~/repos/imsg/bin/imsg 中有预构建的二进制文件，也可以使用该文件）。

2. 授予权限

所需的 macOS 权限（系统设置 → 隐私与安全性）：

权限	位置	用途
完全磁盘访问权限	隐私与安全性 → 完全磁盘访问权限	读取消息历史记录
自动化	隐私与安全性 → 自动化	通过 Messages.app 发送消息

3. 启用 SMS 中继（可选）

若要向非 iMessage 用户发送 SMS（绿色气泡）：

1. 在 iPhone 上：设置 → 信息 → 短信转发
2. 启用转发到 Mac

命令

列出最近的聊天

imsg chats --limit 10
imsg chats --limit 10 --json

输出格式：[chat_id] (identifier) last=timestamp

查看聊天记录

# View last 20 messages in a chat
imsg history --chat-id <id> --limit 20

# With attachments metadata
imsg history --chat-id <id> --limit 20 --attachments

# Filter by date
imsg history --chat-id <id> --start 2026-01-01T00:00:00Z --json

发送消息

# Send to phone number
imsg send --to "+15555555555" --text "Hello!"

# Send with attachment
imsg send --to "+15555555555" --text "Here's the file" --file /path/to/file.jpg

# Force iMessage or SMS
imsg send --to "+15555555555" --text "Hi" --service imessage
imsg send --to "+15555555555" --text "Hi" --service sms

# Send to existing chat by ID
imsg send --chat-id 86 --text "Hello!"

监听新消息

imsg watch --chat-id <id> --debounce 250ms

最佳实践

电话号码格式

• 使用 E.164 格式：美国号码使用 +1XXXXXXXXXX
• 国际号码请包含国家/地区代码

SMS 与 iMessage

• iMessage（蓝色气泡）：Apple 设备用户的默认方式，免费
• SMS（绿色气泡）：需要 iPhone 中继，运营商可能会收费
• 收件人没有 iMessage 时，使用 --service sms

Agent 消息礼仪

• 简洁明了——消息应简短清晰
• 自然得体——写得自然，不要像机器人
• 说明上下文——跟进时，请提及之前的对话
• 注意时间——避免在清晨或深夜发送消息

常见用例

安排服务

imsg send --to "+14155551234" --text "Hi! Do you have availability this Saturday for a cleaning?"

跟进

imsg send --to "+14155551234" --text "Just wanted to follow up on my earlier message. Let me know when you have a chance!"

确认预约

imsg send --to "+14155551234" --text "Confirming our appointment for Saturday at 10am. See you then!"

故障排除

问题	解决方案
出现“not authorized”错误	为终端授予自动化权限
无法读取消息	为终端授予完全磁盘访问权限
SMS 无法发送	在 iPhone 上启用短信转发
消息一直处于发送状态	检查 Messages.app 是否已登录且运行正常

技术说明

• 使用 AppleScript 发送消息（不使用私有 API）
• 读取操作只读 Messages SQLite 数据库
• 需要 macOS 14+，并配置好 Messages.app
• 二进制文件位置：~/repos/imsg/bin/imsg（请根据需要调整路径）