beeper

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

⭐2stars🔀0forks📁View on GitHub🕐Updated Jan 8, 2026⬇️1downloads

When & Why to Use This Skill

The Beeper skill enables Claude to interact with your unified local chat history from various platforms including WhatsApp, Telegram, Signal, iMessage, and Discord. By leveraging the beeper-cli, it provides a powerful, read-only interface for full-text searching, thread browsing, and message extraction, allowing users to treat their multi-platform conversations as a searchable knowledge base.

Use Cases

  • Cross-Platform Information Retrieval: Search for specific keywords, invoices, or project details across all your messaging apps simultaneously without switching between them.
  • Contextual Conversation Analysis: Use proximity search and context windows to understand the background of specific discussions or decisions made in past chats.
  • Thread Summarization: Extract recent messages from specific threads to have Claude summarize long discussions or provide a status update on ongoing conversations.
  • Data Extraction for Productivity: Pull structured data from chat histories, such as meeting times or action items, and format them into tasks or calendar events.
namebeeper
descriptionSearch and browse local Beeper chat history (threads, messages, full-text search).
homepagehttps://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-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

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