Agent skill · software engineering · sundial-org
roadrunner
Beeper Desktop CLI for chats, messages, search, and reminders.
Why this skill is useful
Adds specific command patterns and API interactions for Beeper Desktop that the AI wouldn't reliably generate on its own.
What it needs
Requires brew, go installed locally. About 3k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
roadrunner (rr) Use rr when the user explicitly wants to operate Beeper Desktop via the local API (send, search, list chats/messages, reminders, focus). Prefer --agent for agent use (forces JSON, envelope, no-input, readonly). Safety Require explicit recipient (chat ID) and message text before sending. Confirm or ask a clarifying question if the chat ID is ambiguous. Use --agent for safe agent defaults: rr --agent --enable-commands=chats,messages,status chats list 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" Setup (once) rr auth set <token> rr auth status --check rr doctor Common commands List accounts: rr accounts list --json Capabilities: rr capabilities --json Search contacts: rr contacts search "<account-id>" "Alice" --json Search contacts (flag): rr contacts search "Alice" --account-id="<account-id>" --json Resolve contact: rr contacts resolve "<account-id>" "Alice" --json Resolve contact (flag): rr contacts resolve "Alice" --account-id="<account-id>" --json List chats: rr chats list --json Search chats: rr chats search "John" --json Search chats (filters): rr chats search --inbox=primary --unread-only --json Search chats (activity): rr chats search --last-activity-after="2024-07-01T00:00:00Z" --json Search by participant name: rr chats search "Jamie" --scope=participants --json Resolve chat: rr chats resolve "Jamie" --json Get chat: rr chats get "!chatid:beeper.com" --json Create chat (single): rr chats create "<account-id>" --participant "<user-id>" Create chat (group): rr chats create "<account-id>" --participant "<user-a>" --participant "<user-b>" --type group --title "Project Chat" --message "Welcome!" Default account for commands: rr --account="imessage:+123" chats list --json Account aliases: rr accounts alias set work "slack:T123" List messages: rr messages list "!chat …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/roadrunner