mb CLI Reference
Masterblaster (mb) is an AI agent sandbox management, build, and infrastructure tool for operators embracing safe, sandboxed agentic workflows. It manages stereOS virtual machines, bootstraps agent environments, and provides the foundation for the Paper Compute ecosystem.
Usage
mb [command]
Commands
Sandbox Lifecycle
| Command | Description |
|---|
mb init | Create a jcard.toml configuration file |
mb up | Create and start a sandbox |
mb down | Stop a running sandbox |
mb destroy | Remove a sandbox and all its resources |
Inspection
| Command | Description |
|---|
mb list | List all sandboxes |
mb status | Show the status of a sandbox |
mb ssh | SSH into a running sandbox |
Mixtapes
| Command | Description |
|---|
mb pull | Pull a mixtape from the registry |
mb mixtapes | Manage stereOS mixtapes |
Daemon & Other
| Command | Description |
|---|
mb serve | Start the Masterblaster daemon |
mb version | Display version information |
Global Flags
| Flag | Description |
|---|
--config-dir string | Config directory (default: $XDG_CONFIG_HOME/mb) |
--disable-telemetry | Disable anonymous telemetry |
-h, --help | Help for mb |
-v, --verbose | Enable verbose output |
Quick Start
# Initialize a new sandbox configuration
mb init
# Pull a mixtape image
mb pull coder
# Boot the sandbox
mb up
# SSH into it
mb ssh
# When done, stop and destroy
mb down
mb destroy