skills.rest
johntheyoung
johntheyoungCOMMUNITY
Explore all skills by this author →
GitHub

roadrunner

Automate Beeper Desktop chat, messaging, search, and reminder workflows via the local rr CLI.

5|Updated Jan 16, 2026
Search Tags:#automation#cli#messages#chats#rr#beeper
One-click install
npx skills add https://github.com/johntheyoung/roadrunner --skill roadrunner
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: roadrunner
Source: https://github.com/johntheyoung/roadrunner/tree/main
Command: npx skills add https://github.com/johntheyoung/roadrunner --skill roadrunner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Roadrunner provides a local command-line interface to operate Beeper Desktop, enabling automation and scripting of chats, messages, searches, and reminders without relying on the GUI.

Core Features & Use Cases

  • Local Beeper Desktop API client (rr) for listing chats, sending messages, searching conversations, and managing reminders across multiple accounts.
  • Supports agent safety features (enable-commands, readonly), envelope-wrapped JSON, and account alias resolution for streamlined automation.
  • Use cases include automated setup checks, CI/test scripts, batch workflows, and data extraction or reporting from Beeper data.

Quick Start

Install rr, authenticate with your Beeper API token, and run rr chats list to view your chats.

Frequently Asked Questions about roadrunner

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

FAQPage Schema
How do I automate Beeper chats and reminders from the command line?▼

You can automate Beeper chats and reminders by using a local CLI client that interacts directly with the Beeper Desktop API. This approach supports listing chats, sending messages, and managing reminders without needing the graphical interface.

Can I send messages across multiple Beeper accounts using a CLI tool?▼

Yes, you can send messages across multiple Beeper accounts using a CLI tool that supports account alias resolution. This allows you to target specific accounts programmatically within your automated workflows.

Does the Beeper local API support search and batch messaging workflows?▼

The Beeper local API supports search and batch messaging workflows through a CLI client. It enables you to search conversations and extract data, which is useful for CI test scripts and automated reporting.

What are the safety features for automating Beeper Desktop interactions?▼

Safety features for automating Beeper Desktop interactions include agent-safe modes such as enabling specific commands and setting readonly restrictions. It also offers envelope-wrapped JSON output to ensure structured and safe data handling.

Do I need a Beeper API token to use local chat automation scripts?▼

Yes, you need a Beeper API token to authenticate and use local chat automation scripts. The CLI client ensures proper token handling to securely connect and operate with the local Beeper Desktop environment.

Limitations of using a local CLI compared to the Beeper Desktop GUI?▼

Using a local CLI for Beeper automation requires running the Desktop application locally and handling API tokens manually. It does not offer visual feedback, meaning all interactions and outputs must be managed through structured text or JSON envelopes.

Related Skills

Explore More Software Engineering Skills→
DavidTejuDavidTeju
9

beeper

Automate cross-platform messaging access and control from the terminal.

Community
Advanced
VitorAndTxrVitorAndTxr

figma-desktop

Extract Figma design data via REST API into structured JSON reports.

Community
Advanced
mosaxivmosaxiv
328

cron

Schedule reminders and recurring tasks using cron expressions and timing parameters.

Community
Intermediate
lachlanchenlachlanchen
1

wechat-labcanvas-chatops

Automate WeChat chatops with GUI interactions and task routing in LabCanvas.

Community
Advanced