yolobox

• ваш каталог проекта смонтирован по его реальному пути, например /Users/you/project
• агент имеет полные права и sudo внутри контейнера
• ваш домашний каталог не монтируется, если вы явно не согласитесь на это
• постоянные тома сохраняют инструменты, конфигурации и сессии между запусками
• Claude, Codex и Kimi Code получают встроенные подсказки yolobox, чтобы понимать песочницу, в которой они работают

ИИ может безнаказанно буйствовать внутри песочницы. Ваш настоящий домашний каталог? Неприкосновенен.

Быстрый старт

Затем из любого проекта:

Другие ярлыки ИИ работают так же:

Установите default_harness = "codex", чтобы голый yolobox запускал Codex. Используйте yolobox shell, когда нужна ручная оболочка, и yolobox run <cmd...>, когда нужно выполнить одну команду в песочнице.

Полные детали установки и запуска находятся в Установка и настройка. Примеры команд — в Команды.

Что внутри?

Базовый образ включает ИИ-CLI, Node.js, Python, Go, Bun, инструменты сборки, Git, GitHub CLI, ripgrep, fd, fzf, jq, vim, RTK и прочие практичные мелочи.

Нужно что-то ещё? У агента есть sudo.

Внутри yolobox поддерживаемые ИИ-CLI обёрнуты так, чтобы пропускать запросы разрешений. Никаких подтверждений, никаких предохранителей. Только чистый нефильтрованный ИИ, как задумано природой.

Полный список инструментов, таблицу YOLO-обёрток, заметки по RTK, политику свежести npm-пакетов и поведение обновления встроенных CLI см. в Что внутри.

Настройка проекта

Если одному проекту нужны дополнительные инструменты или переменные окружения, добавьте небольшой конфиг проекта вместо форка всего базового образа:

Затем запускайте как обычно:

Настройка на уровне проекта также может наслаивать фрагмент Dockerfile поверх базового образа. Первый запуск собирает производный образ; последующие запуски переиспользуют его, пока базовый образ или входные данные настройки не изменятся.

Используйте пути контейнера для значений env, поскольку они передаются напрямую процессу внутри yolobox. Значения env передаются в среду выполнения без изменений; ничего в них не интерпретируется.

Чтобы передать песочнице другое значение, чем использует хост под тем же именем — например, токен только для чтения вместо вашего настоящего — задайте псевдоним через env_from_host (или --env-from-host KEY=HOST_VAR):

Псевдоним владеет этой переменной: он подавляет автоматическую передачу и --gh-token для того же ключа, а yolobox отказывается запускаться, если переменная хоста не задана, так что заменяемый токен никогда не сможет случайно просочиться.

См. Конфигурация для настроек env проекта и Настройка на уровне проекта для установки пакетов, фрагментов Dockerfile, поведения пересборки, поведения обновления и полностью кастомных образов.

Типовые сценарии

--claude-config инкрементально синхронизирует постоянные настройки Claude и монтирует на лету хост-каталог ~/.claude/projects на чтение/запись, чтобы история возобновления сессий оставалась актуальной. --no-claude-auth сохраняет независимый вход в бокс, но не делает это монтирование истории проекта доступным только для чтения.

Автоматическая настройка RTK оставляет телеметрию отключённой, если вы интерактивно не включите её изнутри бокса командой rtk telemetry enable.

Подробные справочники намеренно размещены на сайте документации:

• Команды: ярлыки, команды обслуживания, fork и примеры
• Конфигурация: глобальная конфигурация, конфигурация проекта, скопированные инструкции, передача env и манифесты контекста
• Флаги: каждый флаг, примечания о совместимости и детали передачи в среду выполнения
• Рецепты: параллельные агенты и маршрутизация веб-приложений

Философия: Это Бокс ИИ, а Не Ваш

yolobox создан для ИИ-агентов, а не для людей. Вы запускаете ИИ и позволяете ему работать.

У агента есть sudo внутри контейнера. Если ему нужен компилятор, база данных, пакет или фреймворк, он может установить их. Именованные тома сохраняют эту настройку между сессиями, так что вам не придётся превращать README в матрицу пакетов на сотню строк. Укажите ему на ваш проект и дайте готовить.

Модель безопасности

yolobox — это защита от случайностей, а не магическая теорема против побега из контейнера.

Он помогает защитить ваш домашний каталог, SSH-ключи, dotfiles, несвязанные проекты и большую часть состояния файловой системы хоста от неосторожных разрушительных команд. Он не защищает смонтированный каталог проекта, секреты, которые вы явно передаёте, действия хоста, которые вы явно мостите, или ядро хоста от уязвимостей побега во время выполнения.

Для более плотного бокса комбинируйте флаги, например:

Если вы беспокоитесь о враждебном коде, а не о неосторожном, используйте более сильную изоляцию, например rootless Podman или виртуальную машину. Полная модель угроз и варианты усиления описаны в Модель безопасности.

Разработка

Процесс для контрибьюторов, команды сайта документации, версионирование и правила релизов находятся в Участие в разработке.

Лицензия

MIT