用途：该技能封装 Beeper Desktop 在 http://localhost:23373/v1/… 暴露的本地 REST API，通过一个仅依赖 Python 标准库的 CLI，让任何能执行 shell 的智能体在用户已连接的聊天网络（WhatsApp、Telegram、Signal、iMessage、Instagram、Matrix 等）中读取、搜索和发送消息。必须先运行 Beeper Desktop 应用，否则所有命令以退出码 2 结束并提示 Beeper Desktop is not running。
主要能力：读取类命令包括 accounts、chats、find-chat、chat、messages、search-messages、search、contacts、list-contacts、download、info；写入类包括 send、edit、react/unreact、new-chat、archive/unarchive、remind/unremind、upload、focus，以及直接调用原始接口的 raw。--json 可在子命令前后使用，输出原始 API JSON 便于程序解析。
使用方式：CLI 路径为 <skill dir>/scripts/beeper，默认安装位置约在 ~/.claude/skills/beeper-whatsapp/scripts/beeper，例如运行 accounts 查看账户。应先执行一次 accounts，用返回的 accountID（必须是原样取值，不得猜测）配合 --account 限定网络；chatID 和 messageID 在 shell 中必须用单引号，避免 !、:、- 触发解析问题。常见流程：先 accounts，再 find-chat 得到 chatID，读取 messages 获取上下文，然后在用户确认后 send。
限制与安全：任何发送、编辑、回应、归档、设置提醒等写入操作，都必须由用户在当前对话中明确要求；发送前须说明聊天标题和所属账号、展示确切文本并等待批准。不要存储、回显、转发或总结消息中的 OTP、PIN、密码或 2FA 码。消息属个人数据，未经要求不要批量导出。edit 仅对用户自己发送的消息有效，WhatsApp 还有时间窗口限制。若返回 HTTP 403，说明令牌缺少写入权限，应提示用户在 Beeper Desktop 重新授权。
已知 API 特性：GET /v1/chats 无限制参数，故 chats 命令改用 /v1/chats/search；消息接口每页 20 条、由 CLI 自动翻页；search-messages 每次最多 20 条，需用 --cursor 翻页；附件 srcURL 通常是已缓存的 file:// 路径；消息正文含少量 HTML，格式化输出会扁平化，--json 返回原始文本；提醒使用毫秒级时间戳，CLI 会自动转换 ISO8601。令牌位于 <skill dir>/token（权限 600），可用环境变量 BEEPER_ACCESS_TOKEN 和 BEEPER_API_URL 覆盖。退出码：0 成功，1 API/HTTP 错误，2 无法连接 Beeper Desktop。