How do I install the Beeper skill?

Run npx skillmds@latest add modbender/beeper in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Beeper skill do?

Search and browse local Beeper chat history (threads, messages, full-text search). It is listed under Coding & Dev Tools on SkillMD.

Is Beeper safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Beeper?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Beeper free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Beeper?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Beeper by modbender — Agent Skill

Name: Beeper
Rating: 4.2 (5 reviews)
Author: modbender

File contents

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

---name: beeperdescription: Search and browse local Beeper chat history (threads, messages, full-text search).--- # Beeper CLI [Beeper](https://www.beeper.com/) 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 ```bash beeper-cli threads list --days 7 --limit 50 --json ``` ### Show Thread Details ```bash beeper-cli threads show --id "!abc123:beeper.local" --json ``` ### List Messages in Thread ```bash beeper-cli messages list --thread "!abc123:beeper.local" --limit 50 --json ``` ### Search Messages (Full-Text) ```bash # 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 ```bash 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) ```bash go install github.com/krausefx/beeper-cli/cmd/beeper-cli@latest ``` ### Option 2: Build from Source ```bash 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: ```bash 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: ```bash beeper-cli search 'invoice' --context 3 --json ```

Frequently asked questions

Beeper