beeper-cli_skill

Overview

This skill provides a command-line wrapper for Beeper Desktop to search chats, read and list messages, manage attachments, and send messages using beeper-cli. It streamlines chat discovery and messaging workflows by exposing concise commands for accounts, chats, messages, assets, and global actions. Use it to automate or script common Beeper Desktop tasks from the terminal.

How this skill works

The skill issues beeper-cli commands against a running Beeper Desktop instance with API enabled and authenticates via the BEEPER_ACCESS_TOKEN environment variable. It exposes chat and message operations (search, list, get, send, edit, archive), asset upload/download, reminders, and window focus actions. Outputs support machine-readable JSON or human-friendly table formats for integration and inspection.

When to use it

• Search all chats and messages from the terminal or scripts.
• Quickly list or read messages in a specific chat without opening the GUI.
• Send or edit messages programmatically, including replies and attachments.
• Upload/download assets and attach them to outgoing messages.
• Automate reminders, chat creation, or periodic chat archival.

Best practices

• Enable Beeper Desktop API in Settings > Developers before use.
• Store BEEPER_ACCESS_TOKEN securely (environment variable or secrets manager).
• Run beeper-cli commands with -o json for script parsing and -o table for human review.
• Confirm message text before sending when automating to avoid accidental posts.
• Upload assets first to get an upload ID, then send messages referencing that ID.

Example use cases

• Search for all mentions of a project: beeper messages search --query "project" --limit 50 and process results in a script.
• Archive stale group chats nightly: beeper chats archive "<chatID>" from an automation job.
• Send a templated notification with attachment: upload asset, then beeper messages send "<chatID>" "Report attached" --upload-id "<uploadID>".
• List recent chats to build an activity dashboard: beeper chats list -o json and feed into analytics.
• Create a reminder in a chat for a meeting: beeper chats reminders create "<chatID>" --time "2025-01-26T10:00:00Z".