roadrunner

roadrunner (rr) — это CLI-инструмент для работы с Beeper Desktop: управление чатами, сообщениями, поиском и напоминаниями через локальный API.

Используйте rr, когда необходимо напрямую взаимодействовать с Beeper Desktop: отправлять сообщения, искать переписки, просматривать чаты или работать с напоминаниями. Для агентного режима рекомендуется использовать флаг --agent, который включает JSON-формат, безопасные ограничения и отсутствие интерактивного ввода. :

Безопасность

• По умолчанию используйте только команды чтения, если пользователь явно не запрашивает изменения.
• Перед отправкой сообщения обязательно указывайте получателя (chat ID) и текст.
• Если chat ID неоднозначен — уточните его у пользователя.
• Никогда не вставляйте «сырые» ответы CLI (JSON, списки чатов и т.д.) в сообщения — извлекайте только нужную информацию.
• Используйте --agent для безопасного режима по умолчанию.
• Используйте --readonly для полного запрета записи.
• Ограничивайте доступные команды через --enable-commands.
• Используйте --envelope для структурированных ошибок и подсказок.
• Никогда не передавайте и не храните токены авторизации в чате.
• При отправке текста через shell избегайте интерполяции — используйте безопасный ввод через stdin.

Первичная настройка

• rr auth set --stdin — задать токен (сохраняется локально)
• rr auth status --check — проверить авторизацию
• rr doctor — диагностика окружения

Основные команды

• rr accounts list --json — список аккаунтов
• rr capabilities --json — доступные возможности
• rr contacts search "Alice" --json — поиск контактов
• rr contacts resolve "Alice" --json — определение контакта
• rr chats list --json — список чатов
• rr chats search "John" --json — поиск чатов
• rr chats get "!chatid:beeper.com" --json — получить чат
• rr messages send — отправка сообщения

Дополнительные возможности

• Работа с контактами: поиск, разрешение и фильтрация
• Фильтрация чатов по активности, непрочитанным сообщениям и участникам
• Поддержка JSON и JSONL для интеграций и автоматизации
• Просмотр событий в реальном времени через WebSocket
• Интроспекция команд через встроенные describe-инструменты

Инструмент ориентирован на автоматизацию и интеграцию: он позволяет безопасно управлять коммуникациями, минимизируя риски утечки данных и ошибок при работе с API. :