roadrunner

Overview

Beeper Desktop CLI for chats, messages, contacts, connect info, websocket events, search, and reminders.

Key Features

• List accounts: rr accounts list --json
• Capabilities: rr capabilities --json
• Connect metadata: rr connect info --json
• Live websocket events (experimental): rr events tail --all --stop-after 30s --json
• List contacts: rr contacts list "<account-id>" --json
• Search contacts: rr contacts search "<account-id>" "Alice" --json
• Resolve contact: rr contacts resolve "<account-id>" "Alice" --json

How It Works

The roadrunner skill uses the Beeper Desktop CLI to interact with chats, messages, contacts, connect info, websocket events, search, and reminders. It provides a set of common commands to perform various tasks, such as listing accounts, capabilities, connect metadata, and live websocket events.

Use Cases

• Use rr to operate Beeper Desktop via the local API (send, search, list chats/messages, reminders, focus).
• Use --agent for agent use (forces JSON, envelope, no-input, readonly).
• Use --readonly to block writes: rr --readonly chats list --json
• Use --enable-commands to allowlist: rr --enable-commands=chats,messages chats list --json
• Use --envelope for structured errors: rr --json --envelope chats get "!chatid"