Brood Box CLI
CLI bbox запускает Claude Code, Codex и другие агенты в микровиртуальной машине и показывает дифф перед записью изменений в проект
- 79 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- В виртуальную машину пробрасываются ключи API и токены git, которые вы перечислили, и агент вправе выполнять там произвольный код
- Режим без снимка отключает разбор диффа и дает агенту писать в рабочую папку напрямую
Установка
- Работает в
Ручная установка
task buildСборка из исходников: нужны Go 1.26+ и Task; бинарник появится в bin/.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- В виртуальную машину пробрасываются ключи API и токены git, которые вы перечислили, и агент вправе выполнять там произвольный код
- Режим без снимка отключает разбор диффа и дает агенту писать в рабочую папку напрямую
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Brood Box — консольная программа `bbox`, которая запускает кодовых агентов в изолированной микровиртуальной машине на libkrun с аппаратной виртуализацией: KVM на Linux и Hypervisor.framework на macOS. Команда `bbox claude-code` делает копию рабочей папки по схеме copy-on-write, поднимает машину из образа и открывает интерактивный терминал. После выхода агента `bbox` показывает дифф по каждому файлу, и вы принимаете или отклоняете правки. Из коробки поддержаны Claude Code, Codex, OpenCode, Hermes и Gemini CLI, свои агенты задаются в конфиге. Есть сетевой экран по трем профилям, прокси MCP-серверов ToolHive и проброс токенов для git. Проект экспериментальный, формат конфига и флаги могут меняться.
Для кого. Разработчикам, которые запускают агентов с широкими правами и хотят оставить их за границей виртуальной машины, и командам с требованиями к изоляции кода.
Подходит, если
- Агент работает без подтверждений, а вы хотите проверить каждую правку до попадания в репозиторий
- Рабочая папка содержит чувствительные файлы, и их нельзя показывать агенту даже по ошибке
- Вы пробуете незнакомый агент и ограничиваете ему сеть профилем `locked`
- На одной машине нужно параллельно гонять Claude Code и Codex на разных копиях проекта
- Агенту нужны MCP-серверы ToolHive, но без доступа к вашей хост-системе
Не подходит, если
- У вас нет Linux с KVM или Mac на Apple Silicon: без аппаратной виртуализации машина не стартует
- Нужна стабильная промышленная основа: README сам предупреждает об экспериментальном статусе
- Агент должен править файлы прямо в проекте без разбора диффа
- Вы запускаете агента в облаке, где вложенная виртуализация недоступна
Пример запроса к агенту
Запусти Claude Code в Brood Box на этом проекте, дай 4 процессора и покажи дифф по каждому файлу после выходаОграничения
Проект экспериментальный: API, флаги и формат конфига меняются без предупреждения. Нужны Linux с доступным `/dev/kvm` или macOS на Apple Silicon, ключ API вашего агента, например `ANTHROPIC_API_KEY` для Claude Code, и Go 1.26 или новее при сборке из исходников. Прошивку `libkrunfw` программа скачивает при запуске и кэширует в `~/.cache/broodbox/firmware/`. Через `env_forward` и токен git внутрь машины попадают только перечисленные вами секреты. Режим без снимка пишет в проект напрямую и разбор правок отключает.
Как отключить. Каждая сессия эфемерна и ничего не оставляет после выхода. Чтобы убрать программу, удалите бинарник `bbox` из `/usr/local/bin/` и кэш `~/.cache/broodbox/`.
Частые вопросы
Как запустить Claude Code в Brood Box?
Экспортируйте `ANTHROPIC_API_KEY` и выполните `bbox claude-code` в папке проекта. После выхода из сессии программа покажет дифф по файлам для принятия или отклонения.
Чем микровиртуальная машина лучше контейнера?
Контейнер делит с хостом ядро, а здесь агент работает в настоящей виртуальной машине с аппаратной изоляцией KVM или Hypervisor.framework.
Какие агенты поддерживаются?
Claude Code, Codex, OpenCode, Hermes и Gemini CLI. Команды: `bbox claude-code`, `bbox codex`, `bbox opencode`, `bbox hermes`, `bbox gemini`. Прочие описываются в конфиге или запускаются через `bbox run-image`.
Какие файлы агент не увидит?
Файлы вроде `.env`, `*.pem`, `.ssh/` и `.aws/` всегда исключены из снимка, даже если `.broodboxignore` пытается их разрешить.
Как ограничить сеть агента?
Выберите один из трех профилей сетевого экрана: permissive, standard или locked. Фильтр учитывает DNS-имена.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI создает отдельные виртуальные машины для кодинг-агентов, чтобы запускать инструменты разработки вне основной системы.
Один бинарный файл запускает кодинг-агентов в песочнице: микровиртуалка, сетевые правила и скрытые от агента секреты.
VibeKit запускает Claude Code, Codex и другие CLI-агенты через прокси: вымарывает секреты в ответах, ведет журнал сессий, по флагу прячет агента в Docker
Песочница для команд и кода от ИИ-агента: запись, сеть и переменные среды закрыты по умолчанию, ключи подставляются только для разрешенных доменов
Локальная панель для Claude Code, Codex CLI и OpenCode: что грузит агент, сколько это токенов, и проверка MCP-серверов
Claude Code, Codex, OpenCode и pi работают в усиленном контейнере: файлы только проекта, сеть по белому списку, ключи в прокси.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Brood Box (эта карточка) | да | 79 | ||
| Agent-Sandbox | нет | ключ необязателен | 232 | песочница для запуска кода по MCP; Brood Box изолирует самого агента и проверяет диффы |
| sandbox-mcp | нет | 422 | контейнерные песочницы под MCP-инструменты; здесь аппаратная виртуализация и снимок рабочей папки |
Коротко о README
README объясняет идею изоляции агентов на уровне ядра, перечисляет возможности, шаги быстрого старта, таблицу поддерживаемых агентов с образами и ресурсами по умолчанию, схему работы и модель безопасности. Подробности вынесены в каталог docs.