
Позвольте вашему ИИ выложиться на полную. Ваша домашняя директория остаётся в безопасности.
██╗ ██╗ ██████╗ ██╗ ██████╗ ██████╗ ██████╗ ██╗ ██╗
╚██╗ ██╔╝██╔═══██╗██║ ██╔═══██╗██╔══██╗██╔═══██╗╚██╗██╔╝
╚████╔╝ ██║ ██║██║ ██║ ██║██████╔╝██║ ██║ ╚███╔╝
╚██╔╝ ██║ ██║██║ ██║ ██║██╔══██╗██║ ██║ ██╔██╗
██║ ╚██████╔╝███████╗╚██████╔╝██████╔╝╚██████╔╝██╔╝ ██╗
╚═╝ ╚═════╝ ╚══════╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝
Пусть ваш ИИ разгуляется на полную. Ваш домашний каталог остаётся дома.
Документация: yolobox.dev
Список изменений: CHANGELOG.md
Запускайте Claude Code, Codex, Kimi Code, Gemini, Antigravity, OpenCode, Copilot, Pi или любого агента для программирования с ИИ в «yolo-режиме», не уничтожая свой домашний каталог.
Агенты для программирования с ИИ невероятно мощны, когда им разрешают выполнять команды без запроса разрешения. Но стоит один раз неверно истолковать запрос — и после rm -rf ~ вы восстанавливаетесь из резервной копии (ага, конечно, как будто у вас есть резервные копии, ха).
yolobox запускает вашего ИИ-агента внутри контейнера, где:
/Users/you/projectИИ может совершенно свободно разгуляться внутри песочницы. А ваш настоящий домашний каталог? Неприкосновенен.
# Install via Homebrew
brew install finbarr/tap/yolobox
# Or install via script
curl -fsSL https://raw.githubusercontent.com/finbarr/yolobox/master/install.sh | bash
Homebrew автоматически устанавливает дополнения для bash и zsh. Для установки через скрипт см. shell completions.
Затем из любого проекта:
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.
Базовый образ включает AI CLI, адаптеры Codex и Claude ACP, Node.js, Python, Go, Bun, инструменты сборки, Git, GitHub CLI, ripgrep, fd, fzf, jq, vim, RTK и обычный набор практичных утилит.
Нужно что-то ещё? У агента есть sudo.
Внутри yolobox поддерживаемые AI CLI обёрнуты так, чтобы пропускать запросы разрешений. Никаких подтверждений, никаких ограничений. Просто чистый нефильтрованный ИИ, как и задумано природой.
Для ACP-клиента или редактора используйте yolobox run codex-acp или yolobox run claude-agent-acp в качестве команды stdio-агента. Адаптеры включают совместимые движки и используют режимы разрешений клиента; CLI-обёртки YOLO в yolobox и --no-yolo на них не влияют. Применяются существующие параметры синхронизации конфигурации и аутентификации. Примеры запуска см. в разделе ACP clients.
Прогресс загрузки образа и сборки пользовательского образа выводится в stderr, оставляя stdout и stdin через конвейер для команды контейнера, в том числе при запуске ACP.
Полный список инструментов, таблицу обёрток режима 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 для настроек окружения проекта и 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 copilot --copilot-config # Share Copilot settings, login, and session history
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
yolobox reset --force # Remove yolobox volumes from the configured runtime
Сброс работает с Docker, Podman и Apple container. Он удаляет только существующие тома yolobox и завершается успешно, если таковых не осталось. yolobox uninstall --force также очищает эти тома перед удалением бинарного файла и глобальной конфигурации; сбой среды выполнения останавливает удаление, чтобы его можно было повторить. Добавьте --keep-volumes к uninstall, чтобы сохранить данные среды выполнения.
Образ включает OpenCode v2 (@opencode/cli). yolobox update-agents opencode также устанавливает v2, предварительно удаляя старый пакет opencode-ai из постоянного префикса npm, чтобы избежать конфликта лаунчера. Установки явно разрешают требуемый postinstall-скрипт. Существующие установленные пользователем копии v1 остаются на месте, пока вы их не обновите; простой загрузки нового образа недостаточно для замены постоянных инструментов.
OpenCode v2 сохраняет команду opencode и существующие расположения конфигурации. Сделайте резервную копию своей настройки перед переключением: плагины v1 и интеграции с серверным API требуют миграции. См. руководство по миграции upstream.
Откройте для себя самые используемые инструменты нашего сообщества.
Данных о популярности пока нет.