- name
- beeper
- description
- Search and browse local Beeper chat history (threads, messages, full-text search).
- homepage
- https://github.com/krausefx/beeper-cli
- metadata
- {"clawdbot":{"emoji":"🛰️","os":["darwin","linux"],"requires":{"bins":["beeper-cli"]},"install":[{"id":"go","kind":"go","pkg":"github.com/krausefx/beeper-cli/cmd/beeper-cli","bins":["beeper-cli"],"label":"Install beeper-cli (go install)"}]}}
Beeper CLI
Beeper 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-clibinary 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.dbBEEPER_DB=/path/to/index.db
Commands
List Threads
beeper-cli threads list --days 7 --limit 50 --jsonShow Thread Details
beeper-cli threads show --id "!abc123:beeper.local" --jsonList Messages in Thread
beeper-cli messages list --thread "!abc123:beeper.local" --limit 50 --jsonSearch Messages (Full-Text)
# 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 --jsonDatabase Info
beeper-cli db info --jsonNotes
- Read-only: This tool never sends messages
- JSON output: Always use
--jsonfor 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)
go install github.com/krausefx/beeper-cli/cmd/beeper-cli@latestOption 2: Build from Source
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/binExamples
Search for work-related messages from last week:
beeper-cli threads list --days 7 --json | jq '.threads[] | select(.name | contains("work"))'
beeper-cli search 'project deadline' --limit 10 --jsonFind messages about invoices with context:
beeper-cli search 'invoice' --context 3 --json