Skip to content
TakoAPI
Back to skills

beepctl

by blqke

Search & Research
2.0kDownloads reported by clawskills.sh
1Stars
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

Use when sending messages, searching chats, or managing conversations.

Description

What This Skill Does

beepctl is a CLI for the Beeper Desktop API that lets you send messages, search conversations, and manage chats across multiple messaging platforms from the terminal. It wraps Telegram, WhatsApp, Slack, iMessage, and other platforms connected to Beeper into a single unified interface.

Instead of switching between separate apps for each platform, you control Telegram, WhatsApp, Slack, and iMessage through one CLI.

When to Use It

  • Searching for a specific message across all connected messaging platforms
  • Sending yourself a quick note without switching to any app
  • Setting a follow-up reminder on a chat thread
  • Archiving old conversations from a script or automation
  • Replying to a message using an alias instead of a long chat ID

Example Workflow

INPUT

User asks: Find messages about the deploy from yesterday and reply to the most recent one

AGENT
  1. 1

    Runs beepctl search "deploy" --after "1d ago" to find matching messages

  2. 2

    Identifies the most recent result, noting its chat ID and message ID

  3. 3

    Shows the user the proposed reply text and target message for confirmation

  4. 4

    After user confirms, runs beepctl send <chat-id> "<reply>" --reply-to <msg-id>

OUTPUT

Reply sent to the most recent deploy-related message from the past day

Requirements

  • Beeper Desktop app installed and running
  • Beeper account
  • Beeper API token (set via `beepctl auth set <token>`)

Installation

clawhub install blqke/beepctl

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

Links