Beeper

# Beeper CLI

[Beeper](https://www.beeper.com/) 是一款通用聊天应用，可将来自 WhatsApp、Telegram、Signal、iMessage、Discord 等的消息统一在一个收件箱中。

此技能提供对本地 Beeper 聊天记录的**只读访问权限**。您可以浏览会话、搜索消息并提取对话数据。

## 要求 - 已安装 Beeper Desktop 应用程序（提供 SQLite 数据库） - PATH 路径中有 `beeper-cli` 二进制文件

## 数据库路径 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`

## 命令

### 列出会话 ```bash beeper-cli threads list --days 7 --limit 50 --json ```

### 显示会话详情 ```bash beeper-cli threads show --id "!abc123:beeper.local" --json ```

### 列出会话中的消息 ```bash beeper-cli messages list --thread "!abc123:beeper.local" --limit 50 --json ```

### 搜索消息（全文） ```bash # 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 ```

### 数据库信息 ```bash beeper-cli db info --json ```

## 注意事项 - **只读**：此工具从不发送消息 - **JSON 输出**：始终使用 `--json` 以便智能体解析结构化输出 - **FTS5 搜索**：使用 Beeper 内置的全文索引 (FTS5) 进行快速搜索 - **DM 名称解析**：可选地通过桥接数据库解析 DM 名称（使用 `--no-bridge` 禁用）

## 安装

### 选项 1：Go 安装（推荐） ```bash go install github.com/krausefx/beeper-cli/cmd/beeper-cli@latest ```

### 选项 2：从源码构建 ```bash 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 ```

## 示例

搜索上周与工作相关的消息： ```bash beeper-cli threads list --days 7 --json | jq '.threads[] | select(.name | contains("work"))' beeper-cli search 'project deadline' --limit 10 --json ```

查找有关发票的消息及上下文： ```bash beeper-cli search 'invoice' --context 3 --json ```