@@ -24,16 +24,38 @@
2424 <a href="README.zh.md">简体中文</a>
2525</p>
2626
27−VibeBox is a lightweight, ultra-fast sandbox that lets AI agents run commands, modify files, and execute code freely
28−without permission prompts securely. It is completely isolated using Apple's Virtualization Framework, so your actual
29−system
30−stays
31−safe with minimal memory and disk usage.
27+VibeBox is a lightweight, ultra-fast sandbox for AI agents to run commands, edit files, and execute code inside an
28+isolated Apple Virtualization Framework micro-VM, no repeated permission prompts, minimal memory/disk overhead.
3229
3330[](https://vibebox.robcholz.com)
3431
3532---
3633
34+### Why I built VibeBox
35+
36+I use agents like Codex and CC a lot, but I always felt uneasy running them directly on my host machine. If I lock
37+things
38+down, I get interrupted by constant “are you sure?” prompts. If I loosen it up, I worry the agent might touch the
39+wrong files or run something I didn’t intend.
40+
41+I wanted something that feels as frictionless as giving an agent a real shell, but with a hard isolation boundary. So I
42+built VibeBox: a per-project micro-VM sandbox that starts fast, keeps changes contained to the repo, and lets me iterate
43+without babysitting permissions.
44+
45+### Comparison
46+
47+Here’s why I didn’t just use existing options:
48+
49+- **vibe**: super convenient, but it’s too minimal for what I need. It lacks basic configuration, and it doesn’t give me
50+ the multi-instance + session management my workflow wants.
51+- **QEMU**: powerful, but the configuration surface area is huge. For day-to-day sandboxing it’s not “open a repo and
52+ go” — it’s a project on its own.
53+- **Docker / devcontainers**: great ecosystem, but for daily use it feels heavy. Cold starts can be slow, and it’s not
54+ something I can jump into instantly, repeatedly, all day.
55+
56+That’s what pushed me to build **VibeBox**: I wanted a per-project sandbox that’s fast to enter (just `vibebox`),
57+supports real configuration + sessions, and keeps a hard isolation boundary.
58+
3759### Installation
3860
3961```bash