The Construct CLI
Один бинарный файл запускает кодинг-агентов в песочнице: микровиртуалка, сетевые правила и скрытые от агента секреты.
- 61 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- CLI запускает агентов в песочнице и сам проксирует их трафик с подменой ключей; рабочий каталог проекта остается смонтирован в песочницу.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/EstebanForge/construct-cli/main/scripts/install.sh | bashПервая команда быстрой установки из README для macOS и Linux.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI запускает агентов в песочнице и сам проксирует их трафик с подменой ключей; рабочий каталог проекта остается смонтирован в песочницу.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
The Construct поднимает чистую изолированную песочницу, где работают 14 агентов, включая Claude Code, Codex, Copilot, OpenCode, Amp, Cline, Goose и Antigravity. По умолчанию это микровиртуалка (через microsandbox), а на хостах без ее поддержки запасным вариантом служит среда запуска OCI. Агент видит только каталог, из которого его запустили. Настоящие ключи API остаются на хосте: прокси подставляет агенту похожие на ключи заглушки и проверяет исходящий трафик. Сеть настраивается четырьмя уровнями (`allowlist`, `open`, `internet`, `none`), хост-репозитории Git закрываются от записи, а при запуске с `--clone` изменения выходят в виде пакета Git.
Для кого. Тем, кто запускает агентов с широкими правами на своей машине и хочет оградить хост от внедрения промптов и случайных удалений.
Подходит, если
- Агенту поручена опасная миграция, и хост должен остаться нетронутым.
- Ключи API нельзя показывать агенту ни в файлах, ни в переменных окружения.
- Несколько агентов работают параллельно в разных ветках, и нужны отдельные рабочие деревья Git.
- Агент браузера должен открывать локальный сайт на `localhost` на хосте.
Не подходит, если
- Нужен полный доступ агента к хосту: песочница ограничивает пути и сеть.
- Среда без поддержки микровиртуалок и без среды запуска OCI.
- Работа идет на нативном Windows: поддерживается только WSL.
Пример запроса к агенту
construct claude "Помоги отрефакторить эту функцию" в песочнице с политикой сети allowlist и без доступа к ключам.Ограничения
Работает на macOS, Linux и Windows через WSL. Первый запуск `construct sys image init` готовит образ песочницы и ставит агентов. В режиме `internet` и `open` сеть шире, чем в `allowlist`, поэтому для строгой изоляции выбирают `allowlist` или `none`. Прокси проверяет HTTPS через динамические сертификаты листовых узлов, это нужно учитывать корпоративным политикам. Блокировка `.git` на хосте использует атрибуты `chattr +i` или `chflags uchg`. Подробные сведения о параметрах лежат в `docs/CONFIGURATION.md`.
Как отключить. Удалите бинарный файл и PATH-шимы командой из `docs/INSTALLATION.md`, а образы песочницы и кеш в `~/.cache/construct` очистите вручную.
Частые вопросы
Как установить Construct?
`curl -fsSL https://raw.githubusercontent.com/EstebanForge/construct-cli/main/scripts/install.sh | bash` на macOS и Linux. Есть также `mise use -g github:EstebanForge/construct-cli` и `brew install EstebanForge/tap/construct-cli`.
Как запустить агента?
Сначала `construct sys image init`, затем `construct claude "задача"`. Команда `construct sys shims install` заставит обычный `claude` запускаться в песочнице.
Как скрываются секреты?
Прокси на хосте подставляет вместо реальных ключей заглушки. Режим Hide Secrets не дает агенту видеть секреты в файлах и окружении.
Какие уровни сети есть?
Четыре: `allowlist` с наборами для npm, PyPI, crates, Go, GitHub и apt, `open`, `internet` и `none`. Диагностика доступна через `construct sys network explain`.
Можно ли работать без изменения рабочей копии?
Да, запуск с `--clone` создает одноразовую копию, а правки экспортируются пакетом Git.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI bbox запускает Claude Code, Codex и другие агенты в микровиртуальной машине и показывает дифф перед записью изменений в проект
CLI создает отдельные виртуальные машины для кодинг-агентов, чтобы запускать инструменты разработки вне основной системы.
Claude Code, Codex, OpenCode и pi работают в усиленном контейнере: файлы только проекта, сеть по белому списку, ключи в прокси.
Изолированная коробка для кодинг-агентов на своей машине: доступ только к нужным проектам и ключам, пакеты из защищенного реестра
agents-sandbox запускает кодового агента внутри отдельной микровиртуальной машины, скрывая от него остальную систему и секреты.
CLI-песочница для AI-агентов без контейнеров и демонов: запускает Claude Code, Codex или OpenCode с ограниченным доступом к файлам, сети и учетным данным
Коротко о README
Установка занимает одну строку, настройка образа идет отдельной командой. Список агентов и все параметры вынесены в документы каталога `docs`.