Brood Box 是一个实验性的 CLI 工具，旨在让编码智能体在硬件隔离的 microVM（微虚拟机）中运行，而不是仅依赖容器隔离。它通过 libkrun 和 KVM（Linux）或 Hypervisor.framework（macOS）启动轻量级虚拟机，为智能体提供与本地终端相似的交互体验，同时将智能体对工作区的访问限制在写时复制（COW）快照中。
主要用途是安全地运行编码智能体。智能体通常需要访问工作区、API 密钥以及执行任意代码的能力，Brood Box 通过硬件隔离降低信任风险。它支持 Claude Code、Codex 和 OpenCode 开箱即用，并可通过配置添加自定义智能体。
主要能力包括：硬件隔离的 microVM，基于 libkrun 和 KVM/Hypervisor.framework；工作区快照与审查，智能体退出后可逐文件查看统一 diff 并接受或拒绝更改；DNS 感知的出站防火墙，提供 permissive、standard、locked 三种配置以控制虚拟机可访问的网络；MCP 工具代理，自动发现并代理 ToolHive MCP 服务器到虚拟机内；Git 集成，转发令牌和 SSH agent 以在虚拟机内执行 Git 操作；临时安全机制，包括每会话 SSH 密钥、仅限本地的连接、对敏感文件的不可覆盖安全模式；零持久状态，每个会话完全临时。
使用方式：可从 GitHub Releases 下载预构建二进制文件，或从源码构建。构建需要 Task、curl、Go 环境及智能体 API 密钥（例如 Claude Code 的 ANTHROPIC_API_KEY）。运行 bbox 命令会创建当前目录的 COW 快照，启动带有 Claude Code 镜像的 microVM，进入交互式终端会话，退出后显示逐文件 diff 审查，接受的更改会刷新回工作区。支持 --review 逐文件交互批准。工作区模式默认为快照模式，也可通过 --workspace-mode=direct 使用直接模式，该模式下写入立即生效，但 --review 和 --exclude 被拒绝，且首次使用需要 --yes。
配置采用三级系统：CLI 标志 > 每工作区配置 > 全局配置。全局配置位于 ~/.config/broodbox/config.yaml，每工作区配置为项目根目录的 .broodbox.yaml。出于安全，每工作区配置中的 review.enabled 和 workspace.mode: direct 被忽略，egress_profile 也不能放宽全局配置。.broodboxignore 使用 gitignore 语法，但安全敏感模式（如 .env*、*.pem、.ssh/、.aws/ 等）始终被排除且不可否定。
适用场景：需要在隔离环境中运行编码智能体并审查其更改的开发者；对智能体访问工作区、密钥和网络有安全顾虑的团队。限制：项目为实验性，API、CLI 参数、配置格式和行为可能在不通知的情况下变化；需要 KVM（Linux）或 Hypervisor.framework（macOS，Apple Silicon）；需要智能体 API 密钥；固件在运行时下载并缓存，系统回退可用但非嵌入。
