← Back to Skills Marketplace
johntheyoung

Roadrunner

by johntheyoung · GitHub ↗ · v0.17.0
cross-platform ✓ Security Clean
5194
Downloads
4
Stars
6
Active Installs
30
Versions
Install in OpenClaw
/install roadrunner
Description
Beeper Desktop CLI for chats, messages, contacts, connect info, websocket events, search, and reminders.
Usage Guidance
Install this only if you trust the Roadrunner rr CLI and are comfortable giving it access to your Beeper account. Keep requests narrow, prefer readonly/agent modes for lookups, and only allow sends or edits when the recipient and message content are explicit.
Capability Analysis
Type: OpenClaw Skill Name: roadrunner Version: 0.17.0 The roadrunner skill is a CLI tool for interacting with Beeper Desktop, providing capabilities to manage chats, messages, and contacts. The SKILL.md file contains extensive safety instructions for the AI agent, explicitly directing it to use read-only modes by default, avoid leaking raw authentication tokens or large data dumps, and use structured error handling. The tool's capabilities (e.g., reading messages, downloading media to ./media) are entirely consistent with its stated purpose as a messaging client, and no evidence of malicious intent or obfuscation was found.
Capability Assessment
Purpose & Capability
The skill’s stated purpose is to operate Beeper Desktop through the rr CLI, and the documented abilities to list/search chats and messages, manage contacts, download/upload assets, send/edit messages, and manage reminders fit that purpose.
Instruction Scope
Runtime instructions default to read-only use, prefer agent/readonly/allowlisted command modes, require explicit recipient and message text for sending, warn on ambiguous chat IDs, and instruct the agent not to expose raw chat output or auth tokens.
Install Mechanism
Installation depends on an external rr binary from a Homebrew tap or a pinned Go module, which is expected for this integration but means users must trust that upstream CLI.
Credentials
Access to local Beeper Desktop, chats, contacts, media, and the Beeper API token is sensitive but proportionate to a Beeper messaging automation skill and is clearly disclosed.
Persistence & Privilege
No hidden background worker or persistence is present in the skill artifact; the main persistent element is the documented Beeper token saved in the local config file for continued authenticated CLI use.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install roadrunner
  3. After installation, invoke the skill by name or use /roadrunner
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.17.0
- Updated underlying CLI install version to v0.17.0. - Added command examples for `describe` (to show flag/command info) and new `--jsonl` (JSON Lines) output for chat and message lists/searches. - Added example of using `--dry-run` to validate mutating requests without actual API changes. - Minor clarifications and expanded examples for several commands and flags.
v0.16.2
roadrunner 0.16.2 adds new commands and updates for Beeper Desktop CLI. - Added `connect info` command for connect metadata. - Added `events tail` for experimental live websocket event streaming. - Added `contacts list` command. - Added message reaction commands: `messages react` and `messages unreact`. - Added chat start command using merged contact hints: `chats start`. - Updated install instructions and examples for the new features and API changes. - Improved OAuth introspection handling in `auth status --check`.
v0.14.4
- Updated installation and usage instructions to prefer `rr auth set` for authentication, removing the requirement for environment variables and config setup in metadata. - Bumped Go module and Homebrew formula to version 0.14.4. - Revised setup and notes to clarify token storage and override behavior. - Removed unused environment/config requirements from metadata for a simpler setup experience.
v0.14.3
roadrunner 0.14.3 - Updated install instructions to use rr version 0.14.3 for Go installation. - Added a new safety guideline: never paste raw rr command output (such as JSON or chat lists) into outgoing messages—summarize or extract only what’s needed. - No other user-facing changes noted.
v0.14.2
- Added a note under "Safety" about avoiding shell interpolation/expansion when sending message text (e.g. to prevent issues with `$`, `!`, or similar characters). - Suggested using `--stdin <<'EOF' ... EOF` for safely sending literal message text via the shell.
v0.14.1
- Updated skill metadata to explicitly require the BEEPER_TOKEN environment variable and the config file ~/.config/beeper/config.json. - Added required env and config under the "clawdbot" metadata for improved setup clarity. - No changes to CLI usage, commands, or documentation content.
v0.14.0
- Updated Go module installation to use version 0.14.0. - No functional or usage changes in documentation or features.
v0.13.0
roadrunner 0.13.0 - Simplified and tightened configuration: removed some config and state requirements; now only requires `BEEPER_TOKEN`. - Improved safety: defaults to read-only unless the user explicitly requests a mutation; never request or accept raw auth tokens in chat. - Mutating commands clearly separated; only allowed by explicit user request, with new guidance for safely handling retries. - Installation instructions updated with version pinning for Go installs. - Added more detailed error reporting: envelope errors include possible next-step hints. - Documentation and examples reworked for better clarity and safer usage.
v0.12.0
roadrunner 0.12.0 - Added detailed metadata about required config files, environment variables, and state directories for improved integration and discovery. - Documented new chat and message pagination options, including `--all`, `--max-items`, and automatic multi-page retrieval. - Added/expanded usage examples for sending attachments, uploading files, and editing messages. - Noted new options for bounding participants, streaming attachments, and uploading with metadata overrides. - Improved documentation structure and clarity while expanding command examples.
v0.9.0
roadrunner 0.9.0 changelog: - Added new `--agent` flag for agent-safe defaults (enables JSON, envelope errors, no-input, and readonly). - Introduced `rr capabilities --json` command for full CLI capability metadata. - Now supports default account selection with `--account` and the `BEEPER_ACCOUNT` environment variable. - Added account alias features (`accounts alias set`). - Enhanced contact and chat search/resolve commands with flag-based alternatives. - Updated documentation with new safety practices and improved sample usages.
v0.8.0
Version 0.8.0 introduces new global options for safer and more controlled command usage. - Added `--readonly` flag to block write operations. - Introduced `--enable-commands` to allowlist specific commands. - Added `--envelope` option for structured error responses in JSON. - Expanded documentation, including details on error codes and the `rr version --json` feature array.
v0.7.3
Version 0.7.3 of roadrunner - No file changes detected in this release. - No updates to functionality or documentation.
v0.7.2
Fix display name
v0.7.1
- Added note: The message JSON field `downloaded_attachments` is only populated when `--download-media` is used. - No other changes to usage or interfaces.
v0.7.0
No user-facing changes detected for version 0.7.0 (no file changes).
vv0.7.0
roadrunner v0.7.0 - Added `rr messages list --download-media --download-dir` option to download message media while listing. - Added `rr messages context` command to fetch context messages around a specific message. - Added `rr status --by-account` and `rr unread` commands. - Message JSON now includes `is_sender`, `is_unread`, `attachments`, and `reactions`.
v0.6.2
Version 0.6.2 of the "roadrunner" skill - No file or documentation changes detected in this release. - All functionality and usage remain unchanged from the previous version.
vv0.6.2
v0.6.2 - Updated documentation to clarify that rr contacts resolve is strict and fails on ambiguous names. - Now recommends resolving by ID after a contacts search if the contact name is ambiguous. - No functional changes to commands or APIs; documentation update only.
vv0.6.1
v0.6.1 — No changes detected - No file or documentation changes in this version. - The skill remains functionally and descriptively identical to the previous release.
vv0.6.0
Version v0.6.0 - Added new "resolve" commands: `rr contacts resolve` and `rr chats resolve`. - Introduced `rr messages wait` to wait for a message matching specific criteria. - Added `rr status --json` for status summaries. - Documentation updates for new commands and usage examples.
Metadata
Slug roadrunner
Version 0.17.0
License
All-time Installs 196
Active Installs 6
Total Versions 30
Frequently Asked Questions

What is Roadrunner?

Beeper Desktop CLI for chats, messages, contacts, connect info, websocket events, search, and reminders. It is an AI Agent Skill for Claude Code / OpenClaw, with 5194 downloads so far.

How do I install Roadrunner?

Run "/install roadrunner" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Roadrunner free?

Yes, Roadrunner is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Roadrunner support?

Roadrunner is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Roadrunner?

It is built and maintained by johntheyoung (@johntheyoung); the current version is v0.17.0.

💬 Comments