Awesome-openclaw-skills beeper

Search and browse local Beeper chat history (threads, messages, full-text search).

install

source · Clone the upstream repo

git clone https://github.com/sundial-org/awesome-openclaw-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/beeper" ~/.claude/skills/sundial-org-awesome-openclaw-skills-beeper && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/beeper" ~/.openclaw/skills/sundial-org-awesome-openclaw-skills-beeper && rm -rf "$T"

manifest: skills/beeper/SKILL.md

source content

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-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

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 --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

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)

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