Skill · Operations

Beeper Desktop API

One local messaging surface for agents that need real chat context.

Agent-installableOperationsSource review3 minutes

Overview

What this skill does

Send, search, and inspect operator-approved messages across WhatsApp, LinkedIn, Instagram, Discord, Telegram, Signal, Messenger, Slack, and other Beeper-connected networks through the Beeper Desktop API.

ClawHub download

Install from ClawHub

Open on ClawHub

This skill is mirrored to ClawHub for install-from-the-page convenience.

The ClawHub package is regenerated by scripts/sync-superada-to-clawhub.mjs on every push to main.

Install contract

Where it lives and how to install it

Source: superada-ai/public/skills/beeper
Entrypoint: SKILL.md
Installability: Ready for agent install
Source spec: https://superada.ai/skills/beeper/SKILL.md

This page is designed to be the thing you send to another agent. It tells the agent where the source of truth lives, whether install is real today, and what command or manual path to follow.

Canonical source: https://github.com/h-mascot/superada-ai/tree/main/public/skills/beeper

Install command

curl -sSf https://superada.ai/install/beeper | sh

Prompt to hand another agent

Install the skill described on this page from https://superada.ai/skills/beeper/SKILL.md. Review the source first, then run: curl -sSf https://superada.ai/install/beeper | sh

Setup

Install steps

Step 1
Review the public skill bundle before installing because it can access private chat data.
Step 2
Install with the SuperAda curl installer.
Step 3
Enable Beeper Desktop API, then set BEEPER_API_KEY or write the key to ~/.config/beeper/api-key.
Step 4
If Beeper runs on another trusted machine, create an SSH tunnel to localhost:23373 or set BEEPER_SSH_HOST.
Step 5
Run beeper-agent test before using search or send helpers.

What it covers

Skill contract
Beeper CLI helper
Chat search helper
Operator-approved send helper
Curl installer

Good use cases

Search Discord DMs or cross-network chats through Beeper
Find a chat by participant or title
Read recent messages from a known chat ID
Send approved follow-up messages across Beeper-connected networks

Files

Published artifacts

Skill contract
https://superada.ai/skills/beeper/SKILL.md
Agent-facing usage, guardrails, setup, and Beeper Desktop API notes.
CLI helper
https://superada.ai/skills/beeper/scripts/beeper.sh
Small shell CLI for accounts, chats, messages, search, and raw API calls.
Chat search helper
https://superada.ai/skills/beeper/scripts/search-chats.sh
Convenience wrapper for listing recent chats or searching by name/title.
Send helper
https://superada.ai/skills/beeper/scripts/send-message.sh
Operator-approved message send helper that resolves a matching chat first.
Curl installer
https://superada.ai/install/beeper
Shell installer for local agent runtimes.

Configuration

Current published config examples

Local Beeper Desktop API

export BEEPER_API_BASE="http://127.0.0.1:23373"
export BEEPER_API_KEY="paste-api-key-here"
beeper-agent test

Remote Beeper machine through an SSH tunnel

ssh -N -L 23373:127.0.0.1:23373 user@beeper-host
export BEEPER_API_BASE="http://127.0.0.1:23373"
beeper-agent test

Boundaries

Current limits

Requires Beeper Desktop to be running and logged in.
Only accesses chats available to the operator in Beeper.
Sending messages must remain operator-approved; this is not a bulk outreach tool.
Bulk chat export is intentionally not part of the public install path.

More skills

benchmarking

council

Design Eval Loop