yolobox v0.19.4

██╗   ██╗ ██████╗ ██╗      ██████╗ ██████╗  ██████╗ ██╗  ██╗
╚██╗ ██╔╝██╔═══██╗██║     ██╔═══██╗██╔══██╗██╔═══██╗╚██╗██╔╝
 ╚████╔╝ ██║   ██║██║     ██║   ██║██████╔╝██║   ██║ ╚███╔╝
  ╚██╔╝  ██║   ██║██║     ██║   ██║██╔══██╗██║   ██║ ██╔██╗
   ██║   ╚██████╔╝███████╗╚██████╔╝██████╔╝╚██████╔╝██╔╝ ██╗
   ╚═╝    ╚═════╝ ╚══════╝ ╚═════╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═╝

Пусть ваш ИИ отрывается по полной. Ваш домашний каталог остаётся дома.

Документация: yolobox.dev

Список изменений: CHANGELOG.md

Запускайте Claude Code, Codex, Kimi Code, Gemini, Antigravity, OpenCode, Copilot, Pi или любого ИИ-агента для программирования в «yolo-режиме», не снося свой домашний каталог.

Проблема

ИИ-агенты для программирования невероятно мощны, когда вы позволяете им выполнять команды без запроса разрешения. Но одна неверно истолкованная подсказка — и после rm -rf ~ вы восстанавливаетесь из резервной копии (ага, конечно, как будто у вас есть резервные копии, ха-ха).

Решение

yolobox запускает вашего ИИ-агента внутри контейнера, где:

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

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

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

# Install via Homebrew
brew install finbarr/tap/yolobox

# Or install via script
curl -fsSL https://raw.githubusercontent.com/finbarr/yolobox/master/install.sh | bash

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

cd /path/to/your/project
yolobox claude    # Let it rip

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

yolobox codex
yolobox gemini
yolobox kimi
yolobox agy
yolobox antigravity
yolobox opencode
yolobox copilot
yolobox pi

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

Полные сведения об установке и среде выполнения находятся в разделе Installation & Setup. Примеры команд — в разделе Commands.

Что внутри?

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

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

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

Для ACP-клиента или редактора используйте yolobox run codex-acp или yolobox run claude-agent-acp в качестве команды stdio-агента. Адаптеры включают совместимые движки и используют режимы разрешений клиента; CLI-обёртки YOLO из yolobox и --no-yolo ими не управляют. Существующая синхронизация конфигурации и параметры аутентификации применяются. Примеры запуска см. в разделе ACP clients.

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

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

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

# .yolobox.toml
env = ["CODEX_HOME=/home/yolo/.codex-account"]

[customize]
packages = ["default-jdk", "maven"]

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

yolobox run mvn --version

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

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

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

# .yolobox.toml
env_from_host = ["GH_TOKEN=YOLOBOX_READONLY_GH_TOKEN"]

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

См. Configuration для настроек env проекта и Project-Level Customization для установки пакетов, фрагментов Dockerfile, поведения пересборки, поведения обновления и полностью пользовательских образов.

Типичные рабочие процессы

yolobox setup                         # Configure global defaults
yolobox config                        # Show resolved config for this project
yolobox claude --docker --gh-token    # Give the agent Docker and GitHub access
yolobox claude --claude-config --no-claude-auth # Share config, keep the box login independent
yolobox codex --rtk                   # Enable RTK command-output compression
yolobox run --no-network make test    # Run one command with no network
yolobox fork --name bruno codex       # Give an agent its own project copy
yolobox upgrade                       # Update binary and pull the latest image
yolobox update-agents                 # Update AI CLIs and ACP adapters in the persistent box

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

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

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

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

Философия: это песочница ИИ, а не ваша

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

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

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

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