Vibe

Vibe 提供了一种快速、零配置的方式，在 Mac 上启动 Linux 虚拟机，从而为 LLM Agent 提供沙箱环境：

$ cd my-project
$ vibe

░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░▒▓███████▓▒░░▒▓████████▓▒░
░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░
 ░▒▓█▓▒▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░
 ░▒▓█▓▒▒▓█▓▒░░▒▓█▓▒░▒▓███████▓▒░░▒▓██████▓▒░
  ░▒▓█▓▓█▓▒░ ░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░
  ░▒▓█▓▓█▓▒░ ░▒▓█▓▒░▒▓█▓▒░░▒▓█▓▒░▒▓█▓▒░
   ░▒▓██▓▒░  ░▒▓█▓▒░▒▓███████▓▒░░▒▓████████▓▒░

Host                                      Guest                    Mode
----------------------------------------  -----------------------  ----------
/Users/dev/work/my-project                /root/my-project         read-write
/Users/dev/.cache/vibe/.guest-mise-cache  /root/.local/share/mise  read-write
/Users/dev/.m2                            /root/.m2                read-write
/Users/dev/.cargo/registry                /root/.cargo/registry    read-write
/Users/dev/.codex                         /root/.codex             read-write
/Users/dev/.claude                        /root/.claude            read-write
/Users/dev/.gemini                        /root/.gemini            read-write

root@vibe:~/my-project#

在我的 M1 MacBook Air 上，启动大约仅需 10 秒。

依赖环境

• 搭载 ARM 架构芯片且运行 MacOS 13 (Ventura) 或更高版本的 Mac。
• 首次运行时需要网络连接，以便下载并配置 Debian Linux 基础镜像。
• 仅此而已！

为什么要使用 Vibe？

• 使用 --yolo 模式时，LLM Agent 的使用体验更好，因为它们无需频繁中断你来确认指令。
• 在虚拟机中隔离 Agent，让它能够随心所欲地安装或卸载任何工具，而不会损坏你的真实系统。
• 通过控制共享给虚拟机沙箱的目录，你可以精准掌控 Agent（以及上游 LLM 提供商）能看到的内容。 （该项目的灵感源于我曾在不带 --yolo 参数的情况下运行 codex，却发现它试图读取我启动目录之外的文件 —— 这可太糟糕了。）

我选择使用虚拟机而非容器的原因：

• 相比容器或 MacOS 的沙箱框架，虚拟化在防止恶意逃逸方面更为安全。
• 无论如何，MacOS 上的容器也需要启动虚拟机才能运行。

最后，基于个人偏好与风格：

• 该二进制文件是单个可执行文件，没有后台守护进程，且完全不依赖 Docker。

用法

vibe [options]

选项:
  --net                                              虚拟机网络模式（默认 `nat`）。
                                                     提供接口（如 `en0`）可将虚拟机暴露在该接口上。
                                                     这就像直接插上网线一样，它将获得自己的 IP 地址，能够接受入站连接等。

  --cpus                                             虚拟 CPU 数量（默认 2）。
  --ram                                              内存大小（单位 MB，默认 2048）。
  --script                                           在虚拟机中运行脚本。
  --send                                             向虚拟机发送 `some-command` 并换行。
  --expect  [timeout-seconds]                        在执行下一个 `--script` 或 `--send` 之前，等待控制台输出中出现 `string`。
                                                     如果在超时时间内（默认 30 秒）未出现该字符串，则报错并关闭虚拟机。

在不带磁盘镜像的情况下调用 vibe 会执行以下操作：

• 将当前目录共享给虚拟机。
• 将包管理器的缓存目录共享给虚拟机，避免重复下载软件包。
• 将 ~/.codex 目录共享给虚拟机，以便你使用 OpenAI 的 codex。
• 将 ~/.claude 目录共享给虚拟机，以便你使用 Anthropic 的 claude。
• 将 ~/.gemini 目录共享给虚拟机，以便你使用 Google 的 gemini-cli。

首次运行 vibe 时，它会下载一个 Debian Linux 镜像到 ~/.cache/vibe/，并配置好 gcc、mise-en-place、ripgrep、rust 等基础工具，最后保存为 default.raw。 （详情请参考 provision.sh）

当你随后在项目目录中运行 vibe 时，它会将默认镜像复制为 .vibe/instance.raw，启动它，并将你的终端连接到该虚拟机。

当你 exit 这个 Shell 时，虚拟机即会关闭。 磁盘状态会一直保留，直到你手动删除它。 这里没有集中的虚拟机注册表 —— 如果你想删除某个虚拟机，只需删除对应的磁盘镜像文件即可。

其他说明

• Apple 的 VZNATNetworkDeviceAttachment 在宿主机网络状态发生变化（例如切换 Wi-Fi/以太网/VPN）时会丢包并导致虚拟机崩溃，而 VZBridgedNetworkDeviceAttachment 则需要申请受限的 com.apple.vm.networking 授权。