Manual

Command reference for masterblaster (mb), the CLI that manages stereOS sandboxes.

mb serve

Start the Masterblaster daemon. Listens on ~/.config/mb/mb.sock for CLI commands and manages all VM lifecycle operations. Must be running before using other commands.

mb serve
mb serve --verbose

mb init

Create a jcard.toml configuration file in the current directory.

mb init

Edit the generated file to customize the sandbox, then run mb up to boot it.

mb pull

Pull a mixtape image from the registry.

mb pull opencode-mixtape
mb pull opencode-mixtape:0.1.0

mb up

Boot a new sandbox using the jcard.toml in the current directory. If the daemon is not running, it starts automatically in the background.

mb up
mb up --config /path/to/jcard.toml

mb ssh

SSH into a running sandbox.

mb ssh
mb ssh my-sandbox

mb status

Show the current state of a sandbox, including name, state, mixtape, resources, and SSH address.

mb status
mb status my-sandbox
mb status --all

mb list

List all sandboxes.

mb list

mb down

Gracefully stop a running sandbox. Sends a shutdown command to stereosd inside the VM, allowing it to unmount shared directories and sync filesystems before powering off.

mb down
mb down my-sandbox
mb down --force

mb destroy

Remove a sandbox and all its on-disk resources (disk image, EFI vars, state). Attempts a graceful shutdown first.

mb destroy my-sandbox
mb destroy --yes
mb destroy --force --yes

mb mixtapes

Manage mixtape images.

mb mixtapes list

List available mixtapes in the remote registry.

mb mixtapes list
mb mixtapes list coder-arm64  # list tags for a specific mixtape

mb mixtapes local

List locally downloaded mixtapes.

mb mixtapes local

mb mixtapes pull

Pull a mixtape image from the registry.

mb mixtapes pull coder-arm64
mb mixtapes pull coder-arm64:latest

mb mixtapes rm

Remove a locally downloaded mixtape.

mb mixtapes rm coder-arm64          # remove all tags
mb mixtapes rm coder-arm64:latest   # remove specific tag
mb mixtapes rm -f coder-arm64       # skip confirmation

mb version

Print version information.

mb version