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 是一个 Rust CLI,用于启动一次性的隔离虚拟机,让 Claude Code 和 Codex 能以完整的工具访问权限(Docker、git、编译器、包管理器)运行,同时不让你的主机处于风险之中。
这是 GUI 应用还是命令行工具?它是命令行工具,不是 GUI 应用。coop 底层管理 microVM(Linux 上是 Firecracker/KVM,macOS 上是 Lima),你完全通过终端与它交互。
怎么让它跑起来?安装最新发布的二进制文件(如果有 Rust 和 CMake,也可以从源码构建),然后在为项目启动实例之前,先运行 coop setup 构建 VM 模板镜像。
运行 setup 之前需要安装什么东西吗?在 macOS 上必须先通过 brew install lima 安装 Lima,否则 coop setup 会失败;在 Linux 上,setup 会自动安装 Firecracker 并获取一个 guest 内核。
coop 在每台机器上的表现都一样吗?不完全一样 —— 它官方只在 macOS arm64(Apple Silicon)和 Linux x86_64 上经过测试。Linux arm64 构建存在但未经测试,而且每种后端都有自己的主机前提条件。
coop 支持哪些编码智能体?Claude Code 和 Codex 都受支持,各自有单独的集成文档。
为什么用 VM 而不是只用容器?VM 让智能体拥有包括 Docker、编译器和包管理器在内的完整工具访问权限,同时与主机内核完全隔离,这是共享内核的容器无法保证的。
「coop」这个名字怎么发音?它的发音像养鸡的那个「鸡笼」—— 单音节,与「loop」押韵 —— 不是「co-op」。
智能体能在沙箱 VM 里运行 Docker 吗?可以,每个 coop VM 都附带完整的工具访问权限,包括 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