moo

moo <verb> <name> [options]

moo gives every git branch, worktree or agent attempt its own hardware-isolated Linux microVM containing databases, ports, packages and services. Machine state is saved per commit and restored on `git checkout`, enabling true time-travel for the full runtime.It uses copy-on-write, boots quickly, and keeps storage small even with many machines. Primarily for macOS Apple Silicon hosts today (Linux host support planned). Working tree files are synced into the guest on demand (`new`/`run` from inside the repo).The four core verbs are new, run, save, drop. Admin helpers include `ls`, `open`, and `doctor`.

new <name> [from <src>] [--detached]

Create or boot a machine. Prefers a snapshot for the current commit when present. `<src>` may be a git ref/SHA, snapshot ID, or another machine name.

Execute a command inside the machine (services persist between runs).

Snapshot current machine state, associated with the current git commit.

Destroy the live machine (snapshots remain unless `--snapshots`).

List machines, ports, and snapshots.

Print (and open) the host URL for a forwarded guest port.

Run host readiness checks.

- Currently Apple Silicon macOS host + Linux (arm64) guests; alpha pre-1.0 (snapshot format may change).- `moo save` before `git checkout` to preserve unsaved runtime work — `new` prefers the snapshot for HEAD over the live overlay.- Network is fully isolated per machine; use `moo open` / `[network] ports` in `moo.toml` for host reachability.- Base images come from OCI registries without a Docker daemon; Docker is not required.

git(1), docker(1)

Source code · Documentation