coop README

The project's README from github.com/trailofbits/coop. As one markdown file: README.md.

coop

Isolated VM environments for running Claude Code and Codex.

Pronunciation: "coop" (/kuːp/) — one syllable, rhymes with "loop", like the thing you keep chickens in. Not "co-op".

coop is a Rust CLI that manages disposable virtual machines where Claude Code and Codex have full tool access: Docker, git, compilers, package managers, all without risk to your host machine. Each VM is isolated, reproducible, and cheap to create and destroy.

Setup

Install the latest release:

curl -fsSL https://raw.githubusercontent.com/trailofbits/coop/main/install.sh | bash

Or build from source (requires Rust and CMake):

cargo build --workspace --release
cp target/release/coop target/release/coop-proxy /usr/local/bin/

Then build the VM template image:

coop setup

On Linux, coop setup also installs Firecracker and fetches a guest kernel. On macOS, install Lima first (brew install lima) — setup fails without it. coop is tested on macOS arm64 (Apple Silicon) and Linux x86_64; Linux arm64 builds are available but untested. Each backend has its own host requirements — see Prerequisites.

Keep coop updated:

coop update

See coop update and the updates config section.

Usage

Start an instance for the current project and launch an agent CLI:

cd ~/code/my-project
coop up
coop claude
# or
coop codex

Documentation

coop (trailofbits/coop)

Searching Database…

785 ·GitHub
Что это?coop — это CLI на Rust, который поднимает одноразовые изолированные виртуальные машины, чтобы Claude Code и Codex могли работать с полным доступом к инструментам (Docker, git, компиляторы, пакетные менеджеры), не подвергая риску вашу основную машину.
Это приложение с графическим интерфейсом или утилита командной строки?Это инструмент командной строки, а не приложение с интерфейсом. coop под капотом управляет микровиртуальными машинами (Firecracker/KVM на Linux, Lima на macOS), а взаимодействие с ним идёт целиком через терминал.
Как его запустить?Установите бинарник последнего релиза (или соберите из исходников, если у вас есть Rust и CMake), затем выполните coop setup, чтобы собрать шаблонный образ ВМ, прежде чем запускать экземпляр для своего проекта.
Нужно ли что-то установить перед запуском setup?На macOS сначала нужно установить Lima командой brew install lima, иначе coop setup завершится ошибкой; на Linux setup сам установит Firecracker и скачает гостевое ядро.
coop одинаково работает на любой машине?Не полностью — официально он протестирован на macOS arm64 (Apple Silicon) и Linux x86_64. Сборки для Linux arm64 существуют, но не тестировались, и у каждого бэкенда свои требования к хосту.
Какие агенты для кодинга поддерживает coop?Поддерживаются и Claude Code, и Codex, у каждого своя документация по интеграции.
Зачем использовать ВМ вместо обычного контейнера?ВМ даёт агенту полный доступ к инструментам, включая Docker, компиляторы и пакетные менеджеры, оставаясь при этом полностью изолированной от ядра хоста, чего не может гарантировать контейнер с общим ядром.
Как произносится название 'coop'?Оно произносится как курятник — одним слогом, рифмуясь с 'loop', — а не 'co-op'.
Могут ли агенты запускать Docker внутри изолированной ВМ?Да, каждая ВМ coop поставляется с полным доступом к инструментам, включая Docker, git, компиляторы и пакетные менеджеры.
What are similar projects?nvx, brig, arcbox, smolvm, CubeSandbox, agentbox, quicksand, ProxmoxVE
Size
2.2 MB
Stars
785
Age
6mo
Commits · 90 Days