From b1680e54fb4a8d2bc3dc9d7421773b4201cd3d67 Mon Sep 17 00:00:00 2001
From: robcholz <84130577+robcholz@users.noreply.github.com>
Date: Sun, 8 Feb 2026 20:09:43 -0500
Subject: [PATCH] doc: changes

---
 README.md | 16 ++++++++++++++--
 1 file changed, 14 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 821f06b..98e44e1 100644
--- a/README.md
+++ b/README.md
@@ -24,8 +24,20 @@
   <a href="README.zh.md">简体中文</a>
 </p>
 
-VibeBox is a lightweight, ultra-fast sandbox for AI agents to run commands, edit files, and execute code inside an
-isolated Apple Virtualization Framework micro-VM, no repeated permission prompts, minimal memory/disk overhead.
+**VibeBox is a per-project micro-VM sandbox for coding agents on macOS (Apple Virtualization Framework), fast to enter,
+configurable, and built around sessions.**
+
+- **Enter in seconds:** `vibebox` drops you into a reusable sandbox for the current repo
+- **Project-scoped:** explicit mounts + repo-contained changes
+- **Sessioned:** multi-instance + session management (reuse, multiple terminals, cleanup)
+
+### Quick Demo
+
+```bash
+# 1) from any repo
+cd my-project
+vibebox
+```
 
 [![VibeBox Terminal UI](docs/screenshot.png)](https://vibebox.robcholz.com)