Microsandbox — Components
CLI (msb)
| Command |
Purpose |
msb run <image> |
Run a microVM from image (one-shot) |
msb create --name <n> <image> |
Create named persistent sandbox |
msb exec <name> -- <cmd> |
Execute command in named sandbox |
msb stop <name> |
Stop a sandbox |
msb start <name> |
Start a stopped sandbox |
msb rm <name> |
Remove a sandbox |
msb ls |
List all sandboxes |
msb ps <name> |
Show sandbox status |
msb inspect <name> |
Detailed sandbox info |
msb metrics <name> |
Live CPU/memory/network stats |
msb pull <image> |
Pull an OCI image |
msb image ls |
List cached images |
msb image rm <image> |
Remove cached image |
msb install <image> |
Install sandbox as a system command |
msb uninstall <image> |
Remove installed sandbox command |
msb --tree |
Show all commands and options |
Rust SDK
let sandbox = Sandbox::builder("my-sandbox")
.image("python")
.cpus(1)
.memory(512)
.create()
.await?;
let output = sandbox
.exec("python", ["-c", "print('Hello!')"])
.await?;
sandbox.stop_and_wait().await?;
Python SDK
sandbox = await Sandbox.create("my-sandbox", image="python", cpus=1, memory=512)
output = await sandbox.exec("python", ["-c", "print('Hello!')"])
await sandbox.stop_and_wait()
TypeScript SDK
await using sandbox = await Sandbox.builder("my-sandbox")
.image("python").cpus(1).memory(512).create();
const output = await sandbox.exec("python", ["-c", "print('Hello!')"]);
Go SDK
sandbox, _ := microsandbox.CreateSandbox(ctx, "my-sandbox",
microsandbox.WithImage("python"),
microsandbox.WithCPUs(1),
microsandbox.WithMemory(512),
)
output, _ := sandbox.Exec(ctx, "python", []string{"-c", "print('Hello!')"})
MCP Server (microsandbox-mcp)
Separate package (github.com/superradcompany/microsandbox-mcp). Provides structured tool calls for:
- Sandbox lifecycle (create, start, stop, destroy)
- Command execution
- Filesystem access
- Volume management
- Monitoring
Integration: claude mcp add --transport stdio microsandbox -- npx -y microsandbox-mcp
Agent Skills (superradcompany/skills)
Separate repo (github.com/superradcompany/skills). Teaches coding agents (Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot) how to use microsandbox.
Install: npx skills add superradcompany/skills
Internal Components
| Crate |
Purpose |
agentd |
Agent daemon running inside microVM; handles command execution |
runtime |
libkrun wrapper; boots/stops microVMs |
image |
OCI image pull, cache, extraction |
network |
VM networking, port forwarding |
db |
SQLite state (sandbox registry) |
metrics |
Live resource metrics |
filesystem |
Host↔guest file operations |