Beeper CLI

核心用法

beeper 是一个命令行封装工具，用于与 Beeper Desktop API 交互，实现跨平台消息统一管理。无需 MCP 或 curl，直接通过 beeper 命令完成操作。

主要功能模块

账户与聊天管理

• beeper accounts list：查看绑定账户
• beeper chats list/search/get：列出、搜索、获取特定聊天
• beeper chats create/archive：创建新聊天或归档

消息操作

• beeper messages list/search：读取历史消息、全文搜索
• beeper messages send/edit：发送新消息、编辑已发消息
• 支持回复线程 --reply-to、按发送者/时间/Media类型筛选

附件处理

• beeper assets upload/download：上传下载文件
• 发送消息时引用上传ID附加媒体

其他功能

• beeper focus：唤起 Beeper 窗口
• beeper search：全局内容搜索
• 支持 JSON/Table 两种输出格式

显著优点

1. 多平台整合：Beeper 本身聚合 WhatsApp、Telegram、Signal、iMessage 等 15+ 服务，CLI 提供统一操作入口
2. 高效批处理：适合批量搜索历史记录、导出对话、自动化消息发送
3. 开发者友好：纯 Go 实现，源码开源，可自定义扩展
4. 无需常驻 GUI：服务器/远程环境也能管理消息

潜在缺点与局限性

• 依赖重：必须保持 Beeper Desktop 运行并开启 API，无法独立运作
• 手动安装：需自行安装 Go 环境、编译 CLI、配置环境变量
• 令牌管理：BEEPER_ACCESS_TOKEN 需手动获取并安全存储
• 非官方工具：由社区开发者 foeken 维护，非 Beeper 官方出品
• 功能边界：仅覆盖消息 CRUD，不支持语音通话、视频通话等实时功能

适合人群

• 重度 Beeper 用户，需高效批量管理跨平台消息
• 开发者/自动化工程师，希望将消息工作流脚本化
• 需要在无 GUI 环境（服务器、远程 SSH）操作消息的场景

常规风险

• 令牌泄露风险：BEEPER_ACCESS_TOKEN 若泄露可导致账户被完全控制
• 误操作发送：CLI 无二次确认，建议生产环境添加确认逻辑
• API 稳定性：Beeper Desktop API 非公开稳定接口，可能随版本变更
• 隐私合规：批量导出消息可能涉及 GDPR 等数据保护法规

核心用法

beeper Skill 是一个纯文档型的命令行封装工具，本质上是 beeper-cli 的使用指南 wrapper。用户需要先安装 Beeper Desktop 并启用开发者 API，再安装 beeper-cli 工具，最后通过环境变量配置 Access Token 即可使用。该 Skill 提供了完整的聊天管理、消息搜索、发送编辑、附件处理等命令集，支持 JSON 和 Table 两种输出格式，可与 Agent 工作流无缝集成。

显著优点

多平台消息统一：Beeper 本身聚合了 15+ 主流聊天平台（WhatsApp、Telegram、Signal、iMessage 等），该 Skill 让用户能通过单一 CLI 接口管理所有平台消息，彻底解决多应用切换痛点。纯本地架构：所有操作均通过 localhost:29162 本地 API 完成，消息数据不落第三方云端，隐私可控。命令完备：覆盖聊天搜索、消息历史检索、定时提醒、附件上传下载、消息编辑回复等全生命周期管理，堪比官方客户端的核心能力。无代码侵入：Skill 本身为零代码 Markdown 文档，无可执行逻辑，安全性完全取决于外部依赖的透明度。

潜在缺点与局限性

外部依赖风险：核心功能完全依赖个人开发者维护的 beeper-cli（T3 可信度），项目更新频率、长期维护性存在不确定性；若上游停止维护，Skill 将失效。配置门槛较高：需同时满足 Beeper Desktop 运行、Go 环境安装、Token 手动配置三个前置条件，对非技术用户不够友好。平台锁定：仅支持 Beeper Desktop，无法独立运行于其他消息聚合方案或无桌面环境的 headless 服务器。功能边界：无法创建新账户、无法修改账户配置、无法访问端到端加密消息的明文内容（受 Beeper 架构限制）。

适合的目标群体

技术型知识工作者：习惯 CLI 工作流、需要跨平台消息归档搜索的开发者、产品经理、运营人员。自动化需求场景：希望将 IM 通知接入 CI/CD 流水线、监控告警系统，或构建个人消息自动摘要、待办提取等 Agent 工作流的用户。隐私敏感用户：偏好本地处理、不愿将聊天数据同步至云端 SaaS 服务的安全意识较强群体。

使用风险

Token 泄露风险：BEEPER_ACCESS_TOKEN 一旦泄露，攻击者可读取全部消息历史并发送消息，务必存储于密码管理器并避免写入 shell 历史。依赖供应链风险：建议定期审查 beeper-cli 源码更新，警惕恶意代码注入；安装时使用 @latest 标签可能引入未预期变更，建议锁定具体版本。性能瓶颈：大规模消息搜索（如数万条历史）可能因 Beeper Desktop 本地数据库查询效率而响应迟缓。API 稳定性：Beeper Desktop 开发者 API 为非公开稳定接口，未来版本可能变更或移除，导致 Skill 突发失效。