Beeper

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

Security Scan

The skill's requirements and runtime instructions are consistent with its stated goal (read-only local browsing of a Beeper SQLite DB); it is coherent but accesses very sensitive local chat data, so review and trust of the beeper-cli binary/repo is important before use.

Purpose & Capability

Name/description match the actions in SKILL.md: the skill uses the beeper-cli tool to read and search a local Beeper SQLite database. Requiring a beeper-cli binary (and showing how to install it via `go install`) is appropriate for this functionality.

Instruction Scope

Instructions are narrowly scoped to running beeper-cli against a local database and using --json output. They explicitly state read-only behavior. One minor note: DM name resolution can optionally read 'bridge' databases — the skill does not enumerate those paths, so the agent could access additional local bridge DB files if beeper-cli is configured to do so. The skill does not instruct any network calls or reading of unrelated system files.

Install Mechanism

There is no platform-level install spec, but SKILL.md includes an in-doc recommendation to install the binary via `go install github.com/krausefx/beeper-cli/...@latest` or to build from the repository. This is a common, low-risk install path (GitHub/go toolchain). Verify the GitHub repository and its releases/source before running the install command.

Credentials

The skill does not request credentials or broad environment variables. It documents an optional BEEPER_DB env var to override the DB path, which is proportionate to the task. No unrelated secrets or service tokens are requested.

Persistence & Privilege

The skill does not request permanent/always-on inclusion and uses the platform defaults for invocation. It does not declare any capability to modify other skills or system-wide settings.

Assessment

This skill is coherent with its description, but it reads your local Beeper chat database — which contains private messages. Before installing or using it: (1) confirm you have the beeper-cli binary from a trusted source (review the GitHub repo at github.com/krausefx/beeper-cli and its code/maintainer), (2) ensure the binary runs locally and truly performs read-only queries you expect, and (3) consider whether you want an agent with autonomous invocation to be able to run these local reads (agent outputs could leak message contents). Also note the SKILL.md suggests installing via `go install`; the registry metadata does not include a platform install step, so you will need to install the binary yourself. If you are unsure, review the beeper-cli code or run it manually on a test DB first.

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