Minimal CLI
Изолированная коробка для кодинг-агентов на своей машине: доступ только к нужным проектам и ключам, пакеты из защищенного реестра
- 240 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Скрипт установки скачивает и запускает программу из сети, поэтому его надо прочитать заранее
- Неверный minimal.toml может открыть агенту больше доступа к файлам и ключам, чем нужно
- Токены и ключи передаются в песочницу, и их надо выдавать узко
Установка
- Работает в
Ручная установка
curl --proto "=https" --tlsv1.2 -fsSL 'https://go.minimal.dev/stable' | shСтавит канал stable, добавляет min в PATH и автодополнения для bash, fish и zsh. Прочитайте скрипт перед запуском.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скрипт установки скачивает и запускает программу из сети, поэтому его надо прочитать заранее
- Неверный minimal.toml может открыть агенту больше доступа к файлам и ключам, чем нужно
- Токены и ключи передаются в песочницу, и их надо выдавать узко
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Minimal запускает кодинг-агентов в изолированной «коробке» на вашем компьютере. Агент без присмотра трогает только то, что вы ему дали, поэтому доступ ограничивается отдельными проектами, файлами, ключами и настройками. Коробка собирается из файла `minimal.toml`: в нем перечислены нужные агенту инструменты, файлы и механизмы изоляции. На Linux коробка по умолчанию представляет собой непривилегированное пространство имен пользователя, а с `--provider local-minvmd` микровиртуальную машину `libkrun`. На macOS это всегда микровиртуальная машина `libkrun`. Внутри работают git, claude, компиляторы, оболочки и другие программы, которые доставляет защищенный менеджер пакетов из каталога, обновляемого ежедневно. Сейчас в нем упакованы агенты claude, codex, `opencode` и pi. Три команды запускают сеанс: установка, `min init` и `min session activate --attach`. Команда `min dash` открывает интерфейс со всеми сеансами и ветками. Свои редактор, оболочку и конфигурации добавляют «наборами» (`loadouts`). Агентам для установки подходит плагин `minimal` со скиллом `minimal-setup`.
Для кого. Разработчикам и командам, которые запускают агентов без присмотра и хотят ограничить доступ к проектам и ключам, не выключая автономность.
Подходит, если
- Агент работает ночью, и ему нужны только один репозиторий и без ключей
- Новый проект создается внутри песочницы, а токен GitHub выдается уже после выхода агента
- Одному агенту нужны определенные компиляторы и инструменты в известных версиях
- Несколько веток одного репозитория обрабатываются параллельно в разных сеансах
- Команда делится в репозитории файлом minimal.toml, чтобы у всех была одинаковая среда
Не подходит, если
- Windows и другие платформы вне списка: поддержаны macOS на ARM64 и Ubuntu или Debian
- Нужна изоляция без новой утилиты и без установки через curl: Minimal ставится своим скриптом
- Агент должен свободно ходить по всему диску: здесь доступ задается явно
Пример запроса к агенту
Подними сеанс Minimal в этом репозитории с агентом claude и покажи список сеансов в `min dash`Ограничения
Поддерживаются macOS на Apple Silicon и Ubuntu с Debian на ARM64 и x86_64 с ядром Linux не ниже 5.10, а для режима без виртуальной машины нужно разрешенное создание пространств имен без привилегий. Установка идет скриптом через curl, который кладет `min` в PATH и ставит автодополнение, поэтому перед запуском скрипт стоит прочитать. Удаление выполняется тем же скриптом с ключом `--uninstall`. В рабочем примере токен GitHub хранится в связке ключей macOS и раскрывается песочнице только после выхода агента. Последний коммит сделан в ноябре 2026 года.
Как отключить. Выполните скрипт установки с ключом --uninstall: curl --proto "=https" --tlsv1.2 -fsSL https://go.minimal.dev/stable | sh -s -- --uninstall. Файлы minimal.toml и наборы остаются в ваших репозиториях.
Частые вопросы
Что такое коробка Minimal?
Изолированная среда на вашей машине. На Linux это пространство имен пользователя или микровиртуальная машина `libkrun`, на macOS всегда `libkrun`. Ее состав задается файлом minimal.toml.
Как начать за три команды?
Установите Minimal скриптом, в корне репозитория выполните `min init` и затем `min session activate --attach`. Токен GitHub, связка ключей и аккаунт для этого не нужны.
Какие агенты упакованы?
Сейчас claude, codex, `opencode` и pi. Пакеты доставляются защищенным менеджером из каталога, который обновляется ежедневно.
Что такое loadout?
Набор ваших личных настроек поверх проектной среды: редактор, оболочка и конфигурации. Его кладут в каталог ~/.config/minimal/loadouts/dev, например клонированием репозитория.
Как следить за сеансами?
Командой `min dash`: в строках показан сеанс и его ветка, `enter` подключает, q закрывает.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыagents-sandbox запускает кодового агента внутри отдельной микровиртуальной машины, скрывая от него остальную систему и секреты.
Песочница для ИИ-агентов на Linux и macOS без контейнеров: файлы, сеть и системные вызовы закрыты, пока вы не откроете их явно
CLI на Go запускает агента в песочнице ОС: скиллы и секреты доступны через мост, а файлы и сеть изолированы.
Команда safehouse запускает Claude Code, Codex и другие агенты в песочнице macOS: файлы закрыты по умолчанию, нужные папки открываются флагами
CLI-песочница для AI-агентов без контейнеров и демонов: запускает Claude Code, Codex или OpenCode с ограниченным доступом к файлам, сети и учетным данным
Один бинарный файл запускает кодинг-агентов в песочнице: микровиртуалка, сетевые правила и скрытые от агента секреты.
Коротко о README
Описание объясняет, что Minimal запускает агентов в изолированной коробке, перечисляет платформы, установку, раздел для агентов, примеры сеансов и создание проекта внутри песочницы. Дальше рассказано о наборах настроек и ссылки на документацию.