RunTheRepo CLI
Агент запускает GitHub-проекты на Docker Compose в одноразовой песочнице, проверяет сценарии и усиляет защиту с отчетом
- 219 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Запускает чужой код из репозитория, поэтому изоляция держится на Docker Sandboxes и их политике запрета по умолчанию
- Ключ API модели хранится в файле настроек на вашем компьютере и передается проверяющему процессу
Установка
Ручная установка
uv sync --locked --all-groupsИз каталога репозитория, затем uv run playwright install chromium и uv run repotrial doctor до статуса READY; нужны Ubuntu 24.04 в WSL2 и Docker Sandboxes 0.42.0.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Запускает чужой код из репозитория, поэтому изоляция держится на Docker Sandboxes и их политике запрета по умолчанию
- Ключ API модели хранится в файле настроек на вашем компьютере и передается проверяющему процессу
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
RunTheRepo (команда repotrial) запускает публичный репозиторий GitHub с Docker Compose в одноразовой песочнице Docker Sandboxes, привязываясь к точному коммиту. Агент определяет проект, проверяет среду, запускает приложение и прогоняет детерминированные HTTP-проверки: код ответа и содержимое, включая заявленные сценарии с входом. Затем он пробует усилить защиту. Каждая правка проверяется повторным прогоном и сохраняется или откатывается по результату. На выходе отчеты JSON и HTML со ссылками на доказательства и накопленная конфигурация усиления, если происхождение правок подтверждено. Есть локальная веб-консоль: отправляете одну пробу, следите за статусом и открываете отчет. Для пробы с моделью указывают адрес и ключ OpenAI-совместимой конечной точки в расширенных настройках консоли или параметрами --model-endpoint и --model-name. Ключ хранится в файле настроек с правами владельца и не попадает в публичные данные задач.
Для кого. Разработчикам и командам безопасности, которые хотят быстро запустить чужой проект на Docker Compose, проверить его работу и усилить конфигурацию.
Подходит, если
- Нужно проверить, что проект из GitHub действительно запускается на конкретном коммите
- Заявленные пользовательские сценарии надо прогнать HTTP-проверками и получить доказательства
- Конфигурацию Compose хотят ужесточить с откатом каждой правки по результату повторного прогона
- Нужен отчет в JSON и HTML с ссылками на доказательства
Не подходит, если
- Нативный Windows или хост без Docker Sandboxes: поддержки нет
- Закрытые репозитории и проекты без Docker Compose: инструмент рассчитан на публичные
- Тест на проникновение: проверки заданы сценариями и не заменяют аудит
Пример запроса к агенту
Запусти RunTheRepo на публичном репозитории с Docker Compose и конкретным коммитом, проверь вход и главную страницу и покажи отчетОграничения
Рассчитан на Ubuntu 24.04 в WSL2 с файловой системой ext4, systemd, доступной вложенной виртуализацией KVM и Docker Sandboxes версии 0.42.0 с проверенной политикой «запрещено по умолчанию»; нативный Windows и запуск в Docker на хосте не поддерживаются. Нужны uv и Chromium для Playwright, команда repotrial doctor должна сообщить READY. Для целей используйте только отдельные тестовые аккаунты. Лицензия в метаданных GitHub не определена; последний коммит был 15 сентября 2026 года.
Как отключить. Остановите консоль и удалите каталог проекта вместе с окружением uv. Ключ модели лежит в ~/.config/repotrial/model-settings.json, его можно очистить в настройках консоли или удалить файл.
Частые вопросы
Какие среды поддерживаются?
Ubuntu 24.04 в WSL2 с ext4, systemd, вложенным KVM и Docker Sandboxes 0.42.0. Нативный Windows и запуск через обычный Docker на хосте не поддерживаются.
Нужна ли модель?
Для проб с участием модели нужен адрес и ключ OpenAI-совместимого API. Базовые детерминированные проверки HTTP и усиление по шагам описаны отдельно, модель задают в консоли или параметрами --model-endpoint и --model-name.
Что входит в отчет?
Отчеты JSON и HTML со ссылками на доказательства, закрепленный коммит, результаты проверок и накопленная конфигурация усиления, когда происхождение правок подтверждено.
Как запустить веб-консоль?
Командой uv run repotrial serve --port 8765 в том же сеансе WSL, затем откройте http://127.0.0.1:8765/, введите адрес публичного репозитория, полный SHA и внутренний веб-порт.
Где хранится ключ модели?
В файле ~/.config/repotrial/model-settings.json с правами владельца, путь меняется переменной XDG_CONFIG_HOME. API настроек ключ не показывает, в публичные данные задач он не попадает.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыWorkflow GitHub Actions запускаются на вашей машине, а при сбое шаг ставится на паузу, и агент чинит файл и повторяет его.
Container от Aerovato
Container
CLI для постоянных Linux-окружений в Docker или Podman: у каждого проекта свой контейнер, где агент не видит остальную систему
Bash-утилита ru обновляет десятки GitHub-репозиториев одной командой и отдает агентам результат в JSON с кодами выхода.
CLI и приложение для окружений: каждый ИИ-агент получает свой контейнер из общего devcontainer.json, есть MCP-сервер и скилл
Прогревает изолированную среду, переносит в нее ваши изменения и прогоняет тесты, не трогая рабочую машину
Docker-песочница для кодинг-агентов: образ на Debian с Copilot CLI, Codex и Pi, а доступ по SSH, RDP и Docker включается флагами.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| RunTheRepo (эта карточка) | нет | 219 | ||
| sandbox-mcp | нет | 422 | дает агенту песочницы для запуска кода, RunTheRepo прогоняет целые проекты Compose с HTTP-проверками | |
| AIO Sandbox | нет | ключ необязателен | 6 331 | универсальная песочница с MCP, а здесь проверка и усиление чужих приложений |
Коротко о README
В README описан запуск проекта Compose в песочнице: что получаете (закрепленный коммит, проверки HTTP, проверенное усиление, отчеты, локальная консоль), требования к WSL2 и Docker Sandboxes, быстрый старт с uv, пример проверки Umami, правила для учетных данных. Есть китайская версия.