Beeper CLI

核心功能与用法

beeper 是一个针对 Beeper Desktop 的命令行封装工具，通过 beeper-cli 实现无需 MCP 或 curl 的直接命令操作。核心能力覆盖三大模块：

1. 账户与聊天管理：列出账户、搜索/创建/归档聊天、设置提醒
2. 消息操作：列出消息历史、全文搜索（支持按发送者、时间范围、媒体类型过滤）、发送/回复/编辑消息
3. 附件处理：上传/下载文件，支持带附件的消息发送

典型工作流：通过 beeper chats search 定位聊天 → beeper messages list 读取历史 → beeper messages search 检索内容 → beeper messages send 发送消息。输出支持 JSON（默认）和表格两种格式，便于脚本集成或人工阅读。

显著优点

• 跨平台聚合：Beeper 原生整合 15+ 通讯协议（WhatsApp、Signal、Telegram、iMessage 等），CLI 继承此优势，单一入口管理多平台消息
• 开发者友好：纯命令行接口，无 GUI 依赖，适合自动化脚本、CI/CD 集成
• 搜索能力突出：支持全文检索、多维度过滤（时间、发送者、媒体类型、指定聊天），远超多数 IM 原生客户端
• 消息编辑与回复：完整支持消息生命周期管理，包括事后编辑和线程回复
• 轻量部署：单二进制文件，Go 编写，跨平台编译

潜在局限与风险

• 依赖 Beeper Desktop：必须保持桌面客户端运行且开启 API，无法独立作为守护进程
• 访问令牌安全：BEEPER_ACCESS_TOKEN 需用户手动从开发者设置提取，保管不当可导致完整消息权限泄露
• 功能边界：不支持语音/视频通话、复杂媒体编辑、群组管理（权限设置、成员邀请）等高级功能
• 社区维护：由个人开发者（foeken）维护，非 Beeper 官方项目，长期支持存在不确定性
• 隐私合规：Beeper 作为第三方聚合服务，消息数据流经其服务器，对端到端加密协议（如 Signal）有潜在妥协

适合人群

• 需要批量处理跨平台消息的技术用户、自动化工程师
• 偏好终端工作流、希望减少 GUI 切换的开发者
• 需要消息历史检索与归档的数据管理场景

常规风险提示

| 风险类别 | 说明 |

|---------|------|

| 凭证泄露 | `BEEPER_ACCESS_TOKEN` 具有完整读写权限，建议使用密钥管理器存储，避免硬编码 |

| 误操作发送 | CLI 无二次确认，建议先在 `--output table` 模式下验证目标聊天 ID |

| 服务依赖 | Beeper 服务中断或 Desktop 未启动时全部功能失效 |

| 加密降级 | 使用 Beeper 可能削弱原生 E2EE 保障，敏感通讯需谨慎评估 |

核心用法

beeper技能是一个纯文档型Agent Skill，作为Beeper Desktop CLI工具（beeper-cli）的使用指南封装。用户需先在本地安装beeper-cli并配置BEEPER_ACCESS_TOKEN环境变量，即可通过Agent调用各类命令完成：聊天列表查询与搜索（beeper chats list/search）、消息历史读取与关键词检索（beeper messages list/search）、消息发送与编辑（beeper messages send/edit）、文件附件上传下载（beeper assets upload/download）等操作。支持JSON和table两种输出格式，便于自动化处理或人工阅读。

显著优点

1. 多平台消息统一：Beeper本身聚合了iMessage、WhatsApp、Telegram、Signal等15+聊天平台，该技能让用户能通过单一CLI接口管理跨平台消息流。
2. 零代码集成：纯Markdown文档形式，无额外代码执行风险，依赖透明可控。
3. 灵活的搜索能力：支持按关键词、发送者、时间范围、媒体类型等多维度检索历史消息，满足信息追溯需求。
4. 自动化友好：JSON输出格式支持脚本化处理，可构建消息归档、定时提醒等工作流。

潜在缺点与局限性

1. 外部依赖风险：核心功能完全依赖第三方社区项目beeper-cli（Go语言开发），该项目由个人开发者维护，版本更新可能引入breaking changes。
2. 功能受限于上游：Beeper Desktop API的能力边界决定了该技能的功能上限，如某些平台的消息编辑限制、附件大小限制等。
3. 无原生MCP支持：仅通过CLI封装调用，非原生MCP协议集成，跨Agent迁移需重新适配。
4. 环境配置门槛：需要用户自行管理BEEPER_ACCESS_TOKEN，且Beeper Desktop必须保持运行状态，无法独立离线工作。

适合的目标群体

• 多平台消息重度用户：同时使用3个以上聊天工具、需要统一检索历史消息的商务人士
• 自动化运维者：希望将消息通知接入个人工作流（如把特定关键词消息自动转发至待办系统）的效率工具爱好者
• Beeper Desktop现有用户：已在使用Beeper客户端、希望扩展CLI自动化能力的用户群体

使用风险

1. 供应链安全风险：beeper-cli通过go install @latest安装可能引入未审查的更新，建议固定版本号使用。
2. 凭证泄露风险：BEEPER_ACCESS_TOKEN拥有消息读写权限，若存储不当（硬编码在脚本中）可能导致隐私数据泄露。
3. 性能依赖：消息搜索性能受Beeper Desktop本地数据库索引影响，大型聊天室的首次查询可能延迟较高。
4. 服务连续性风险：Beeper为商业产品，API策略可能调整；个人维护的CLI工具存在维护中断可能性。