Crate vvbox 

vvbox - sandboxed runner and library for macOS 26.

This crate exposes the building blocks used by the vvbox CLI so other Rust programs can drive the same workflow: create git worktree snapshots, run commands in Apple containers, and manage run metadata and service containers.

Quick start

use clap::Parser;

let cli = vvbox::cli::Cli::parse();
vvbox::commands::run(cli);

See docs/overview.md and docs/cli.md for a full guide to configuration and the CLI options.

Modules

cli

CLI types and parsing helpers. CLI types for parsing vvbox commands.

commands

Command dispatch and execution. CLI command dispatch and execution.

config

Configuration loading and resolution. Configuration loading and path resolution.

container

Container CLI integration helpers. Helpers for interacting with the Apple container CLI.

git

Git and worktree helpers. Git helpers for resolving repositories and worktrees.

runs

Run metadata and patch management. Run metadata persistence and patch generation.

services

Service container orchestration. Service container orchestration based on config.

types

Core data types used across the crate. Core data types for configuration and run metadata.

util

Small shared utilities. Small utility helpers shared across the crate.