Coi CLI
Coi, CLI контейнеров Incus, сохраняет правки рабочего проекта на хосте от имени владельца файлов, даже после удаления окружения.
- 777 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- В режиме `bypass` агент запускает команды без подтверждения, получает root внутри контейнера и может менять подключенную рабочую папку хоста.
- Явно переданные секреты доступны процессам внутри контейнера.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/coipond/coi/master/install.sh | bashСтавит CLI Coi. Это первая команда README. До запуска изучите установщик и подготовьте Incus.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- В режиме `bypass` агент запускает команды без подтверждения, получает root внутри контейнера и может менять подключенную рабочую папку хоста.
- Явно переданные секреты доступны процессам внутри контейнера.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Coi, CLI системных контейнеров, готовит агенту отдельное Linux-окружение с системными службами и домашним каталогом. Рабочий проект подключается внутрь контейнера. Правки сохраняются на хосте от имени владельца исходных файлов. Контейнер можно сохранить между сессиями или удалить после работы. Профиль задает образ, агента, лимиты ресурсов и сетевой режим. Его можно применять к разным задачам и наследовать от другого профиля. Для параллельной работы в одном проекте создаются отдельные окружения.
Для кого. Инженерам локальных сред разработки, чьим агентам нужны Docker, системные службы и зависимости внутри контейнера.
Подходит, если
- Для тестирования проекта агент запускает Docker и systemd в контейнере.
- Установленные зависимости сохраняют для следующей сессии.
- Параллельные агенты работают в разных домашних каталогах.
- К нескольким проектам применяют общий профиль ресурсов и сети.
Не подходит, если
- Для каждой задачи нужна виртуальная машина с отдельным ядром.
- Нельзя допустить запись агента в подключенный рабочий проект.
- На Linux нельзя установить Incus, а на macOS нельзя подготовить Colima или Lima.
Пример запроса к агенту
Подготовь профиль Coi для тестов проекта с ограниченной сетью, покажи монтирования и проверь профиль до запуска.Ограничения
На Linux нужен Incus; на macOS его запускают через Colima или Lima, которые придется настроить заранее. Системные контейнеры используют общее ядро, поэтому отдельного ядра для каждой задачи здесь нет. Рабочая папка подключается на запись: правки агента сохраняются на хосте даже после удаления контейнера. Секреты хоста не передаются автоматически, но явно подключенные файлы и переменные доступны агенту; проверьте список доступов до начала сессии.
Как отключить. Завершите сессию и остановите контейнер через `coi shutdown`. Перед очисткой остановленных окружений проверьте, какие зависимости и данные нужно сохранить.
Частые вопросы
Как проверить собственный профиль?
Выполните `coi schema profile`, чтобы получить схему, затем `coi validate profile ~/.coi/profiles/<name>/config.toml`, подставив путь к своему файлу. Неизвестные ключи считаются ошибками.
Какие сетевые режимы есть?
Открытый, ограниченный и список разрешенных направлений. Профиль выбирает режим вместе с остальными настройками окружения.
Как посмотреть потребление ресурсов?
Через `coi top`. Он показывает CPU, память и ввод-вывод с привязкой к рабочему каталогу и имени окружения.
Можно ли запустить обычную команду в контейнере?
Да. Например, `coi run -- npm test` передает код завершения и показывает вывод команды.
Что входит в журнал защиты?
События угроз в JSONL. Команда `coi audit` выводит поток, который можно передать своей системе сбора событий.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыCLI создает отдельные виртуальные машины для кодинг-агентов, чтобы запускать инструменты разработки вне основной системы.
Claude Code, Codex, OpenCode и pi работают в усиленном контейнере: файлы только проекта, сеть по белому списку, ключи в прокси.
CLI-песочница для AI-агентов без контейнеров и демонов: запускает Claude Code, Codex или OpenCode с ограниченным доступом к файлам, сети и учетным данным
Защитный слой для кодовых агентов: блокирует разрушительные команды Git и файловой системы и попытки прочитать чувствительные файлы до запуска
Локальная панель для Claude Code, Codex CLI и OpenCode: что грузит агент, сколько это токенов, и проверка MCP-серверов
Команда safehouse запускает Claude Code, Codex и другие агенты в песочнице macOS: файлы закрыты по умолчанию, нужные папки открываются флагами
Коротко о README
Команда `coi health` проверяет настройку установки. Скилл для работы с профилями получает схему из CLI и проверяет по ней ключи конфигурации.