Documentation Index
Fetch the complete documentation index at: https://opensandbox-feat-cf-dev-cutover.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Creating a Sandbox
oc create (shortcut for oc sandbox create) provisions a new sandbox VM:
oc create
oc create --timeout 600 --cpu 2 --memory 2048 --env NODE_ENV=production
The sandbox ID is printed on success. Use --json to capture it programmatically:
ID=$(oc create --json | jq -r '.sandboxID')
Listing & Inspecting
# List all sandboxes
oc ls
# Detailed info for a specific sandbox
oc sandbox get sb-abc123
oc ls shows a table with ID, template, status, CPU, memory, and age. Add --json for machine-readable output.
Hibernation & Wake
Save state and stop paying for compute. Wake resumes the same sandbox — the platform attempts fast snapshot restore with a cold-boot fallback if needed.
oc sandbox hibernate sb-abc123
# ... hours later ...
oc sandbox wake sb-abc123
oc shell sb-abc123
The sandbox keeps the same ID across hibernate/wake cycles. Preview URLs remain active.
Adjusting Timeout
The idle timeout resets on every operation (exec, file access, agent activity). Default: 300s.
oc sandbox set-timeout sb-abc123 3600 # 1 hour
Killing a Sandbox
oc sandbox kill sb-abc123
All data is lost unless you’ve created a checkpoint first.
Common Patterns
Create and Shell In
oc shell $(oc create --json | jq -r '.sandboxID')
Filter Running Sandboxes
oc ls --json | jq '.[] | select(.status == "running") | .sandboxID'
Batch Cleanup
oc ls --json | jq -r '.[].sandboxID' | xargs -I{} oc sandbox kill {}