用途：imsg 是终端命令行工具，用于发送/读取 iMessage 与 SMS、查询本地 Messages 数据库并实时监听来消息。
主要能力：含 chats（列出最近会话）、history（查看某会话历史，支持按参与者与 ISO8601 时间范围过滤、附带附件元数据）、watch（实时流式接收新消息，支持按 chat-id、参与者、起止时间过滤及 --debounce 去重）、send（发送文本和/或附件，可用 --to 号码/邮箱或已有聊天 ID/GUID，--service 选 imessage|sms|auto）、rpc（stdin/stdout 上的 JSON-RPC，进阶）。多数命令支持 --json 输出。
使用方式：先 imsg chats 获取 chat-id，再执行如 imsg history --chat-id 1 --limit 20；发送用 imsg send --to +14155551212 --text "Hi"；监听用 imsg watch --chat-id 1 --debounce 500ms。
限制与注意：读取本地 ~/Library/Messages/chat.db，属敏感文件；新版 macOS 需给终端「完全磁盘访问权限」；Messages.app 打开时数据库可能被锁，遇错误可先关闭；--service auto 在无法走 iMessage 时会回退 SMS（可能产生运营商费用）；号码建议用国际格式。
隐私：消息历史为私有数据，备份与日志需谨慎。其余功能细节与安装方式暂未提供。