iMessage命令行工具

技能简介

imsg 是 macOS 平台的 iMessage/SMS命令行工具，通过终端直接读取 Messages.app 的聊天记录、实时监听消息，并支持发送文本与附件。

业务背景

imsg 为 macOS 用户提供终端级别的消息管理能力，适合需要快速查询聊天记录、批量导出对话或集成消息通知到工作流的场景。无需打开 Messages.app 即可获取信息，提升信息检索效率，同时支持程序化发送，便于与个人自动化工具结合。

落地案例：一位项目经理需要整理与客户的沟通记录。他使用 imsg 导出指定聊天的完整历史消息（含附件）为 JSON 格式，便于后续分析和存档。日常工作中，他设置实时监听重要群聊的新消息，终端即时弹出提醒，确保不错过关键信息，同时避免频繁切换聊天窗口打断编码工作。

能做什么

• 列出最近聊天会话列表
• 导出指定聊天的历史消息（含附件）
• 实时监听特定聊天的 incoming 消息
• 向指定手机号或邮箱发送 iMessage/SMS
• 以 JSON 格式输出便于脚本处理

使用说明

安装指令：

brew install steipete/tap/imsg

前置要求：

1. Messages.app 已登录 Apple ID
2. 终端拥有「完全磁盘访问权限」
3. 授予终端「自动化」权限以控制 Messages.app（发送功能需要）

常用命令：

• 查看最近10条会话：imsg chats --limit 10 --json
• 导出聊天历史：imsg history --chat-id 1 --limit 20 --attachments --json
• 实时监听消息：imsg watch --chat-id 1 --attachments
• 发送消息：imsg send --to "+14155551212" --text "hi" --file /path/pic.jpg

使用 --service imessage|sms|auto 指定发送通道。发送前请确认收件人与内容。

输入与输出

见下方输入与输出表格。

风险提示

• 需开放系统级权限，存在隐私暴露风险
• 误操作可能导致消息误发
• 仅支持 macOS，Windows/Linux 无法运行
• Apple 系统更新可能破坏兼容性

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/steipete/imsg/SKILL.md
来源类型：开源社区