Update README

Author: scttnlsn

README.md

@@ -22,6 +22,8 @@ You'll be prompted for:
 - The install path (default: `/opt/vume`)
 - The ZFS pool device (leave empty for file-backed dev mode; a real device/partition is recommended for production)
 
+Vume requires root because it manages KVM virtual machines, ZFS datasets, and network interfaces (bridge, tap, iptables NAT).
+
 If you install to a non-default path, set `VUME_HOME` in your shell profile:
 
 ```bash
@@ -61,6 +63,65 @@ All configuration is stored in `$VUME_HOME/vume.toml` (default: `/opt/vume/vume.
 
 See `config/vume.toml` for default values.
 
+## CLI Usage
+
+All `vume` commands require root privileges.
+
+### Start a VM
+
+```bash
+sudo vume start                  # auto-generated ID
+sudo vume start --id my-vm       # specific ID
+```
+
+Running `start` with an existing stopped VM's ID will resume it.
+
+### List VMs
+
+```bash
+sudo vume list                   # all VMs
+sudo vume list --status running  # filter by status (running, stopped, error)
+```
+
+### Execute a command in a VM
+
+```bash
+sudo vume exec my-vm "uname -a"
+sudo vume exec my-vm "apt install -y python3" --timeout 120
+```
+
+### Manage background processes
+
+```bash
+sudo vume process start my-vm my-server "python3 -m http.worker"
+sudo vume process stop my-vm my-server
+sudo vume process list my-vm
+sudo vume process logs my-vm my-server --lines 100
+```
+
+### Stop / destroy VMs
+
+```bash
+sudo vume stop my-vm             # stop a running VM
+sudo vume destroy my-vm          # remove a VM completely
+sudo vume destroy                # destroy all VMs (with confirmation)
+```
+
+### View configuration
+
+```bash
+sudo vume config get vcpu
+sudo vume config get network.bridge
+sudo vume config path
+```
+
+### Help
+
+```bash
+vume --help
+vume <command> --help
+```
+
 ## Customizing the rootfs
 
 You can create a custom base image from a running VM. The active rootfs version is tracked
@@ -69,7 +130,7 @@ affecting existing VMs.
 
 ```bash
 # 1. Customize a running VM, e.g.
-vume exec <vm-id> "apt install -y python3 nginx"
+sudo vume exec <vm-id> "apt install -y python3 nginx"
 
 # 2. Snapshot the customized VM and create a new rootfs version
 sudo zfs snapshot vume/<vm-id>@<version>