According to AlphaMoat, as of 2026-09, Beeper has 3,216 downloads and 3 stars — ranked #3,537 of 5,078 AI skills overall, and #305 of 442 in Knowledge.

Installs

106

Downloads

3.2K

Stars

Overall Rank

#3,537

Top 70% overall · Top 70% in Knowledge

Platform	Installs	Downloads	Stars	Comments
ClawHub ↗	102	3.2K	3	-
SkillHub ↗	106	3.2K	3	—

Platforms count differently and update at different times.

What this skill does

The primary says Beeper CLI can list threads, inspect messages, run full-text searches, and extract conversation data; it does not send messages. It requires access to the local Beeper Desktop database, so it exposes sensitive local chat history. Use narrow searches within the user-authorized scope, limit result counts, avoid unnecessary full-conversation extraction, and protect the database path and any exported results.

Profile published 2026-10-29

What you can do with it

Search local chat history for a specific term
Inspect limited context from a specified thread
Organize messages related to a user-specified topic

When to use it

When the user explicitly authorizes access to local Beeper history
When the search scope and result count can be limited to the task
When extraction can avoid unrelated private conversations

Example prompts

Generated from the skill’s documentation as examples; not results of actual runs.

Search one specified thread for a term and limit the number of results

Summarize messages about this work topic without exporting the full conversation

Explain why this tool is read-only and do not send any messages

Monthly Trend

Downloads3.2K

Stars3

The counting method changed in 2026-09: skills with the same name are now counted separately by author, and the full catalog is covered. Dashed lines show months before the change; they are not compared with later months, and no growth is computed across the change.

Month	Downloads	MoM	Stars
2026-09	3.2K	—	3
2026-08	3.1K	+4.2%	3
2026-07	3.0K	+10.6%	3
2026-06	2.7K	+6.0%	3
2026-05	2.5K	—	3
2026-03	2.1K	—	3

SKILL.md (original)

The author’s original file, shown as plain text without edits or review by AlphaMoat. Links are not clickable; check commands before running them. Fetched 2026-10-23.

2.7 KB · ClawHub v0.0.1

---
name: beeper
description: Search and browse local Beeper chat history (threads, messages, full-text search).
homepage: https://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](https://www.beeper.com/) is a universal chat app that unifies messages from WhatsApp, Telegram, Signal, iMessage, Discord, and more in a single inbox.

Show all (97 lines)


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