beepctl

Manage Beeper messages across platforms from the terminal via CLI.

53|2|Updated Jan 13, 2026
One-click install
npx skills add https://github.com/blqke/beepctl --skill beepctl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beepctl
Source: https://github.com/blqke/beepctl/tree/main/skills/beepctl
Command: npx skills add https://github.com/blqke/beepctl --skill beepctl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

beepctl enables you to manage messages across multiple Beeper-supported platforms (Telegram, WhatsApp, Slack, iMessage, and more) directly from the terminal, reducing context switching and manual steps.

Core Features & Use Cases

  • Authentication & setup: Configure access to Beeper accounts and manage API tokens locally.
  • Chat & message management: List chats, view details, search messages, and send messages across connected accounts and chats.
  • Cross-platform workflows: Interact with multiple platforms from a single CLI, including creating, replying to messages, and performing quick searches.

Quick Start

beepctl accounts beepctl chats list beepctl chats show <chat-id> beepctl search "meeting" --after "1d ago" beepctl send <chat-id> "Hello!"

Frequently Asked Questions about beepctl

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage Beeper messages from the terminal?

You can send messages across platforms like Telegram, WhatsApp, and Slack from the terminal using beepctl by passing a chat ID and message text to the send command.

What do I need to set up before using cross-platform messaging in my terminal?

Before using terminal messaging, you need the beepctl npm package installed globally and API tokens configured in ~/.config/beepctl/config.json or via environment variables for authentication.

Can I search messages across multiple platforms like WhatsApp and Telegram at once?

You can search messages across connected platforms like WhatsApp and Telegram at once using the beepctl search command with text queries and time-based filters like '1d ago'.

Does managing Beeper chats from a CLI reduce context switching?

Managing Beeper chats from a CLI reduces context switching by letting you interact with multiple platforms like Slack and iMessage from a single terminal interface instead of separate apps.

What are the limitations of using a CLI for Beeper messaging management?

A limitation of CLI Beeper messaging management is its dependency on the Beeper Desktop API and local configuration files for token access, making it unsuitable for environments lacking terminal access.

Related Skills