Overview

Start with the architecture and runtime model, then move to examples and guides.

Quickstart

# From a clone of void-box
cargo install void-box
voidbox run --file examples/hackernews/hackernews_agent.yaml

Architecture — Host/guest execution model, KVM and VZ isolation boundaries, and system design.
Runtime Model — Provider-to-runtime mapping, skill provisioning, and guest execution flow.
CLI + TUI — Command surface (run, validate, status, logs) and TUI interaction model.
Events + Observability — Structured run events, telemetry, and OTLP export setup.
OCI Containers — Guest images, base images, and OCI skill mounts for composing language runtimes.
Snapshots — VM snapshot and restore, base and diff snapshot types, and storage layout.
Host Mounts — Host directory sharing over 9p or virtiofs, with current platform caveats.
Security Model — Defense in depth, session auth, guest hardening, and platform-specific network controls.
Wire Protocol — AF_VSOCK framing, message types, session authentication, and transport details.