Beeper CLI

Beeper是一款通用聊天应用，可将来自 WhatsApp、Telegram、Signal、iMessage、Discord 等平台的消息统一汇集到一个收件箱中。

此技能提供只读访问您本地 Beeper 聊天历史记录的功能。可浏览会话线程、搜索消息并提取对话数据。

要求

• 已安装 Beeper Desktop 应用（提供 SQLite 数据库）
• beeper-cli二进制文件位于 PATH 环境变量中

数据库路径

CLI 会自动检测：

• ~/Library/Application Support/BeeperTexts/index.db（macOS）
• ~/Library/Application Support/Beeper/index.db（macOS）

可通过以下方式覆盖默认路径：

• --db /path/to/index.db
• BEEPER_DB=/path/to/index.db

命令

列出会话线程

beeper-cli threads list --days 7 --limit 50 --json

显示会话详情

beeper-cli threads show --id "!abc123:beeper.local" --json

列出线程中的消息

beeper-cli messages list --thread "!abc123:beeper.local" --limit 50 --json

搜索消息（全文）

# Simple search
beeper-cli search 'invoice' --limit 20 --json

# Phrase search
beeper-cli search '"christmas party"' --limit 20 --json

# Proximity search
beeper-cli search 'party NEAR/5 christmas' --limit 20 --json

# With context window (messages before/after match)
beeper-cli search 'meeting' --context 6 --window 60m --json

数据库信息

beeper-cli db info --json

注意事项

• 只读：此工具从不发送消息
• JSON输出：始终使用--json以生成代理可解析的结构化输出
• FTS5搜索：使用Beeper内置的全文索引（FTS5）进行快速搜索
• DM名称解析：可选地通过桥接数据库解析DM名称（使用--no-bridge禁用）

安装

选项1：Go Install（推荐）

go install github.com/krausefx/beeper-cli/cmd/beeper-cli@latest

选项2：从源代码构建

git clone https://github.com/krausefx/beeper-cli.git
cd beeper-cli
go build ./cmd/beeper-cli
# Move beeper-cli to PATH, e.g., /usr/local/bin

示例

搜索上周与工作相关的消息：

beeper-cli threads list --days 7 --json | jq '.threads[] | select(.name | contains("work"))'
beeper-cli search 'project deadline' --limit 10 --json

查找关于发票的消息（带上下文）：

beeper-cli search 'invoice' --context 3 --json