← Back to skills
Agent-installable Operations Source review 3 minutes

Beeper Desktop API

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

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.

Install contract
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/henrino3/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

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

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.

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

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.