Fork a Sandbox

from gravixlayer import GravixLayer, ForkError

client = GravixLayer()  # defaults to cloud="aws", region="us-east-1"
sandbox = client.runtime.create()  # defaults to template="base-small"
sandbox.file.write("/workspace/data.txt", "shared\n")

# Fork a running sandbox into 4 children
result = client.runtime.fork(sandbox.runtime_id, count=4)

for child in result.runtimes:
    print(child.runtime_id, child.file.read("/workspace/data.txt").content)
    child.kill()
for err in result.errors:
    print("child failed:", err.code, err.error)

# Fork a saved snapshot instead — no capture, parent need not be alive
result = client.snapshots.fork("my-snapshot", count=3)

import { GravixLayer, forkRuntimes, forkErrors } from 'gravixlayer';

const client = new GravixLayer(); // defaults to cloud="aws", region="us-east-1"
const sandbox = await client.runtime.create(); // defaults to template="base-small"
await sandbox.file.write("/workspace/data.txt", "shared\n");

// Fork a running sandbox into 4 children
const result = await sandbox.fork({ count: 4 });

for (const child of forkRuntimes(result)) {
  console.log(child.runtimeId);
}
for (const err of forkErrors(result)) {
  console.log("child failed:", err.code, err.error);
}

// Fork a saved snapshot instead — no capture, parent need not be alive
const fromSnap = await client.snapshots.fork('my-snapshot', { count: 3 });

# Requires: GRAVIXLAYER_API_KEY, jq

# Fork a running sandbox into 4 children
gravixlayer runtime fork "$RT" --count 4

# Keep the capture as a named snapshot (requires --persist-snapshot)
gravixlayer runtime fork "$RT" --count 2 --persist-snapshot --name shared-base

# Per-child overrides
gravixlayer runtime fork "$RT" --count 3 --timeout 600 \
  -e WORKER=1 --metadata '{"batch":"a"}'

# Fork a saved snapshot instead (name or id) — no capture, parent need not be alive
gravixlayer snapshot fork my-snapshot --count 3

# Requires: GRAVIXLAYER_API_KEY, jq
API="https://api.gravixlayer.ai/v1"
AUTH=(-H "Authorization: Bearer $GRAVIXLAYER_API_KEY" -H "Content-Type: application/json")

# Fork a running sandbox into 4 children
curl -sS -X POST "$API/agents/runtime/$RT/fork" "${AUTH[@]}" \
  -d '{"count": 4}' | jq '.children[] | .runtime.runtime_id // .error'

# Fork a saved snapshot instead (name or id)
curl -sS -X POST "$API/agents/snapshots/my-snapshot/fork" "${AUTH[@]}" \
  -d '{"count": 3}' | jq '.children[] | .runtime.runtime_id // .error'