π¦ ClawHub
Beeper
by @krausefx
Search and browse local Beeper chat history (threads, messages, full-text search).
TERMINAL
clawhub install beeperπ About This Skill
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-cli binary on PATHDatabase 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.dbCommands
List Threads
beeper-cli threads list --days 7 --limit 50 --json
Show Thread Details
beeper-cli threads show --id "!abc123:beeper.local" --json
List Messages in Thread
beeper-cli messages list --thread "!abc123:beeper.local" --limit 50 --json
Search Messages (Full-Text)
# Simple search
beeper-cli search 'invoice' --limit 20 --jsonPhrase search
beeper-cli search '"christmas party"' --limit 20 --jsonProximity search
beeper-cli search 'party NEAR/5 christmas' --limit 20 --jsonWith context window (messages before/after match)
beeper-cli search 'meeting' --context 6 --window 60m --json
Database Info
beeper-cli db info --json
Notes
--json for structured output agents can parse--no-bridge)Installation
Option 1: Go Install (recommended)
go install github.com/krausefx/beeper-cli/cmd/beeper-cli@latest
Option 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/bin
Examples
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 --json
Find messages about invoices with context:
beeper-cli search 'invoice' --context 3 --json
π‘ Examples
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 --json
Find messages about invoices with context:
beeper-cli search 'invoice' --context 3 --json
π Tips & Best Practices
--json for structured output agents can parse--no-bridge)