Skip to content
TakoAPI
Back to skills

beeper

by krausefx

Communication
1.8kDownloads reported by clawskills.sh
2Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Search and browse local Beeper chat history.

Description

What This Skill Does

Read-only CLI tool for searching and browsing your local Beeper chat history. Queries the SQLite database maintained by the Beeper desktop app using full-text search (FTS5). Never sends messages or modifies data.

Lets you search across all unified Beeper networks (WhatsApp, Telegram, iMessage, Discord, Signal, etc.) in a single query instead of switching between apps.

When to Use It

  • Find an invoice someone sent over WhatsApp last month
  • Search across all chat networks for a specific project name
  • Pull recent threads to review weekend messages
  • Locate a shared link from a Signal conversation
  • Extract conversation data from a specific contact or group

Example Workflow

INPUT

User asks: find messages about the Q1 budget from the last two weeks

AGENT
  1. 1

    Run beeper-cli threads list --days 14 --json to identify relevant threads

  2. 2

    Run beeper-cli search 'Q1 budget' --limit 20 --json to find matching messages

  3. 3

    Run beeper-cli messages list --thread <thread-id> --limit 50 --json on matched threads

  4. 4

    Use --context flag to retrieve surrounding messages for fuller conversation context

OUTPUT

List of messages mentioning Q1 budget with thread names, timestamps, and surrounding context

Requirements

  • Beeper Desktop app installed (provides the local SQLite database)

Installation

clawhub install krausefx/beeper

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links