Documentation for people working on BoxLite itself. The contribution process, from setup and pull
requests to commit messages and where each doc goes, is in
CONTRIBUTING.md.
How the code fits together.
- Architecture: components, the VMM abstraction, host-guest RPC, concurrency, and error handling.
- VMM design: BoxLite's own VMM, which is replacing libkrun, with background on Hypervisor.framework, KVM, the Windows Hypervisor Platform, and guest memory.
- Jailer network permissions: guest networking, host IP grants, and the AF_UNIX control plane.
- Container capabilities: the Linux capability API.
How to build, test, and change the code.
- Building from source: prerequisites and build commands.
- Rust style guide: conventions for Rust code.
- CLI development: building, testing, and extending the
boxliteCLI. - E2E local CI runbook: the self-hosted runner behind
e2e-local.yml. - macOS sandbox debugging: find and fix Seatbelt denials.
Dated root-cause analyses and design studies, newest first.
- 2026-10-08 · BoxLite skills in Claude Code: describes the Claude adapter, shared package layout, and installation/acceptance checks.
- 2026-10-08 · CLI device authorization discovery
- 2026-07-19 · Reaper: one wait, one place
- 2026-07-15 · Collapse
start_attachedintoattachandstart - 2026-07-14 · Container init creation via the zygote
- 2026-07-14 · SDK API for run-command semantics
- 2026-07-14 ·
boxlite runcommand: Docker semantics fix - 2026-03-10 · Concurrent exec deadlock
- 2026-02-22 · Boot latency analysis