Agent skill · writing content · sundial-org
beeper
Search and browse local Beeper chat history (threads, messages, full-text search).
Why this skill is useful
Adds specific commands and usage patterns for querying Beeper's chat history that the AI wouldn't reliably generate on its own.
What it needs
Requires beeper-cli installed locally. About 1k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
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 BEEPERDB=/path/to/index.db Commands List Threads Show Thread Details List Messages in Thread Search Messages (Full-Text) Database Info 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) Option 2: Build from Source Examples Search for work-related messages from last week: Find messages about invoices with context:
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/beeper