Beeper
Apps & AutomationbeeperBeeper is an Agent Skill for apps & automation published in the sundial-org/awesome-openclaw-skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Search and browse local Beeper chat history (threads, messages, full-text search).
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/sundial-org/awesome-openclaw-skills/blob/HEAD/skills/beeper/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/beeper, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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 --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
--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@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