devbox

Sandboxed Linux development environment powered by microsandbox.

Prerequisites

• Node ≥22.18 (native TS execution)
• pnpm
• microsandbox CLI (msb)
• Podman (for image building)

Quick Start

pnpm install
pnpm devbox init      # Create sandbox from built image
pnpm devbox shell     # Interactive zsh session
pnpm devbox exec npm run lint   # Run a command inside the sandbox

Image Building

The Arch Linux dev image is built once and loaded into microsandbox:

pnpm image

This builds from archlinux base, installs dev tools (zsh, git, node, pnpm, python, go, nvim, delve, mise, cmake, gcc, etc.), and loads the resulting image as localhost/arch-dev:latest.

CLI Commands

Command	Description
devbox init	Create sandbox from image + baseline snapshot
devbox shell	Interactive zsh session
devbox exec <cmd>	Run a command in the sandbox
devbox start/stop/restart	Manage sandbox lifecycle
devbox status	Show sandbox status
devbox remove	Remove sandbox + snapshot
devbox metrics	CPU/memory usage
devbox logs [-f]	View or follow logs