BranchBox CLI
CLI создает для каждой фичи свое рабочее дерево Git и окружение, чтобы агенты и люди работали параллельно без конфликтов
- 89 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- CLI управляет контейнерами Docker, томами, файлами `.env` и общими каталогами с учетными данными, а снос окружения удаляет рабочие деревья.
Установка
- Работает в
Ручная установка
brew install branchbox/tap/branchboxРекомендуемый способ для macOS из README; для Linux есть скрипт `install.sh`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI управляет контейнерами Docker, томами, файлами `.env` и общими каталогами с учетными данными, а снос окружения удаляет рабочие деревья.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
BranchBox разводит параллельную работу над фичами. Команда `branchbox feature start "Add OAuth Integration"` создает ветку и каталог с отдельным рабочим деревом Git. Подключенные модули могут добавить каждой фиче свой проект Compose, сеть Docker, порты, файл `.env`, имя базы данных и `devcontainer`, а при желании туннель Cloudflare. Границу изоляции выбирают флагом `--runtime`: по умолчанию `container`, экспериментально `sbx` (микровиртуальные машины Docker Sandboxes) и `local-vm` (Firecracker на Linux с KVM). Агента запускают внутри среды фичи командой `branchbox feature exec add-oauth -- codex`. Каждая команда умеет `--json` со стабильным контрактом, на нем держатся и нативное приложение для Mac в предварительной версии, и скрипты агентов. Снос окружения безопасен: `branchbox feature teardown` отказывается удалять рабочее дерево с несохраненными изменениями.
Для кого. Разработчикам, которые гоняют нескольких агентов и свои ветки одновременно и страдают от конфликтов портов, баз данных и контейнеров.
Подходит, если
- Агент пишет одну фичу, а вы правите другую, и рабочие каталоги не должны пересекаться
- Для каждой ветки нужна своя база данных и свой набор портов в Docker Compose
- Агента запускают внутри границы микровиртуальной машины, чтобы ограничить его доступ
- Закончившуюся фичу сносят одной командой с проверкой несохраненных изменений
Не подходит, если
- Одна ветка и один агент: хватит обычного `git worktree` или простой ветки
- Проект без Docker и без потребности в отдельных окружениях для фич
- Нужна готовая облачная песочница: BranchBox работает на вашей машине
Пример запроса к агенту
Создай отдельное окружение для фичи Add OAuth Integration, запусти в нем Codex и покажи, какие порты и какая база ей досталисьОграничения
Успешный `feature start` сообщает лишь о выполненных шагах настройки и не доказывает, что приложение или база запущены: контейнер и миграции запускают отдельно. Фиксированные порты хоста и внешние базы остаются общими, пока проект не разведет их в конфигурации. Провайдеры `sbx` и `local-vm` экспериментальные: первому нужен Docker Sandboxes CLI, второму Linux x86_64 с KVM. Приложение для Mac требует macOS 26 и новее. Файлы из Git-ignore удаляются вместе с рабочим деревом, перед сносом копируйте нужное.
Как отключить. Снесите окружения командой `branchbox feature teardown <имя>` (сначала с `--dry-run`), затем удалите CLI через `brew uninstall branchbox` или удалите бинарный файл скрипта установки.
Частые вопросы
Как установить BranchBox?
На macOS выполните `brew install branchbox/tap/branchbox`. Для Linux и macOS есть скрипт `curl -fsSL https://raw.githubusercontent.com/branchbox/branchbox/main/install.sh | bash`, прочитайте его до запуска.
Что делает `branchbox init`?
Один раз создает реестр и проверяет окружение. В интерактивной оболочке он может спросить про перенос из временного каталога, перестройку репозитория и туннель Cloudflare. Ключ `-y` берет значения по умолчанию.
Как запустить агента внутри фичи?
Выполните `branchbox feature exec add-oauth -- codex`. Команда запускает агента в среде, записанной для этой фичи.
Удалит ли `teardown` мои несохраненные изменения?
Нет, без явного флага отказывается. Для сброса изменений нужен `--discard-changes`, для ветки `--keep-branch` или `--force-delete-branch`, а `--dry-run` покажет план.
Есть ли у BranchBox интерфейс?
Есть предварительная версия приложения для Mac, она работает поверх того же CLI через `--json`. Приложению нужны macOS 26 и новее и `branchbox` 0.13.4 или новее.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыDocker-песочница для кодинг-агентов: образ на Debian с Copilot CLI, Codex и Pi, а доступ по SSH, RDP и Docker включается флагами.
AgentBox запускает Claude Code, Codex и Open Code в отдельных виртуальных машинах: на вашем ПК, своем сервере или в облаке.
ExitBox запускает Claude, Codex, Cursor и других агентов в rootless-контейнерах: сеть по списку доменов, секреты в сейфе.
ArcBox запускает Claude Code в одноразовой микровиртуалке на Mac: своя ОС, пустая рабочая папка и старт примерно за секунду
Запускает каждый этап агента в отдельной микровиртуальной машине: Claude, Codex, Ollama или любой CLI с трассировкой OTLP
Container от Aerovato
Container
CLI для постоянных Linux-окружений в Docker или Podman: у каждого проекта свой контейнер, где агент не видит остальную систему
Коротко о README
README объясняет, почему параллельная работа агентов ломает порты, базы и контейнеры, перечисляет возможности изоляции, дает установку через Homebrew и скрипт, быстрый старт и описание провайдеров среды.