Beeper

# Beeper CLI

[Beeper](https://www.beeper.com/) is a universal chat app that unifies messages from WhatsApp, Telegram, Signal, iMessage, Discord, and more in a single inbox.

This skill provides **read-only access** to your local Beeper chat history. Browse threads, search messages, and extract conversation data.

## Requirements - Beeper Desktop app installed (provides the SQLite database) - `beeper-cli` binary on PATH

## Database Path The CLI auto-detects: - `~/Library/Application Support/BeeperTexts/index.db` (macOS) - `~/Library/Application Support/Beeper/index.db` (macOS)

Override with: - `--db /path/to/index.db` - `BEEPER_DB=/path/to/index.db`

## Commands

### List Threads ```bash beeper-cli threads list --days 7 --limit 50 --json ```

### Show Thread Details ```bash beeper-cli threads show --id "!abc123:beeper.local" --json ```

### List Messages in Thread ```bash beeper-cli messages list --thread "!abc123:beeper.local" --limit 50 --json ```

### Search Messages (Full-Text) ```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 ```

### Database Info ```bash beeper-cli db info --json ```

## Notes - **Read-only**: This tool never sends messages - **JSON output**: Always use `--json` for structured output agents can parse - **FTS5 search**: Uses Beeper's built-in full-text index (FTS5) for fast search - **DM name resolution**: Optionally resolves DM names via bridge databases (disable with `--no-bridge`)

## Installation

### Option 1: Go Install (recommended) ```bash go install github.com/krausefx/beeper-cli/cmd/beeper-cli@latest ```

### Option 2: Build from Source ```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 ```

## Examples

Search for work-related messages from last week: ```bash beeper-cli threads list --days 7 --json | jq '.threads[] | select(.name | contains("work"))' beeper-cli search 'project deadline' --limit 10 --json ```

Find messages about invoices with context: ```bash beeper-cli search 'invoice' --context 3 --json ```