Script the sbx CLI With JSON Output and jq

sbx list | jq -r '.sandboxes[] | select(.name | startswith("jq-demo-")) | [.id, .state, .type, .name] | @tsv'

sb_1xfcnnm3qr	ready	small	jq-demo-1

curl -sS -X PATCH https://sandboxer.com/api/v1/sandboxes/$id \
  -H "Authorization: Bearer $SANDBOXER_API_KEY" -H "Content-Type: application/json" \
  -d '{"labels":{"job":"nightly","repo":"web"}}' | jq -c .sandbox.labels
# {"job":"nightly","repo":"web"}

sbx list | jq -r '.sandboxes[] | select(.labels.job == "nightly") | .id'
# sb_1xfcnnm3qr

sbx list | jq -r '.sandboxes[] | select(.labels.job == "nightly") | .id' |
  while read -r id; do sbx stop "$id" --wait >/dev/null && echo "stopped $id"; done

out="$(sbx info sb_doesnotexist 2>err.json)" || {
  rc=$?
  case "$(jq -r .code err.json)" in
    not_found) echo "already gone (exit $rc, $(jq -r .requestId err.json))" ;;
    *)         jq -r '"failed: \(.code): \(.error)"' err.json; exit "$rc" ;;
  esac
}

already gone (exit 4, req_KyJfdFXkiWbB3iPLleZX)

{"event":"error","error":"Sandbox not found","code":"not_found","status":404,"requestId":"req_RRGfeKI104b7FltiW91F"}
{"event":"error","error":"--type must be small, default, large or xlarge","code":"usage"}
{"event":"error","error":"refusing to delete sb_doesnotexist without --yes in a non-interactive session","code":"usage"}

#!/usr/bin/env bash
# fanout.sh: run one command in N fresh sandboxes, print one JSON result per
# sandbox, and delete every sandbox it made, even on Ctrl-C or an error.
# Usage: N=2 PREFIX=ci-run ./fanout.sh 'python3 -c "print(6*7)"'
set -uo pipefail
N="${N:-2}"
PREFIX="${PREFIX:-fanout}"
CMD="${1:?usage: fanout.sh '<command>'}"
ids=()

cleanup() {
  for id in "${ids[@]}"; do
    sbx delete "$id" --yes >/dev/null 2>&1 && echo "deleted $id" >&2
  done
}
trap cleanup EXIT

# wait_up ID: poll sbx info until the sandbox is up, fail on error states.
wait_up() {
  local id="$1" state
  for _ in $(seq 1 150); do
    state="$(sbx info "$id" | jq -r '.sandbox.state')" || return 1
    case "$state" in
      ready|idle|running) return 0 ;;
      error|cancelled)    echo "$id ended in $state" >&2; return 1 ;;
    esac
    sleep 2
  done
  echo "$id: timed out in $state" >&2
  return 1
}

# 1. Ask for all N at once; --no-wait returns after the "created" line.
for i in $(seq 1 "$N"); do
  out="$(sbx new --type small --name "$PREFIX-$i" --no-wait 2>err.json)" || {
    jq -r '"create failed: \(.code) \(.error)"' err.json >&2; exit 1; }
  ids+=("$(jq -r 'select(.event == "created") | .id' <<<"$out")")
done

# 2. Wait for every one to come up.
for id in "${ids[@]}"; do wait_up "$id" || exit 1; done

# 3. Run the command everywhere; record stdout and the remote exit code.
for id in "${ids[@]}"; do
  res="$(sbx exec "$id" --json --timeout 60 "$CMD")"; code=$?
  jq -c --arg id "$id" --argjson code "$code" \
    '{id: $id, exit: $code, stdout: (.stdout | rtrimstr("\n"))}' <<<"$res"
done

# 4. Show which sandboxes with our prefix are still up before cleanup runs.
sbx list | jq -r --arg p "$PREFIX-" \
  '.sandboxes[] | select(.name | startswith($p)) | "\(.id) \(.state) \(.name)"' >&2

$ N=2 PREFIX=jq-demo ./fanout.sh 'python3 -c "import platform; print(platform.python_version())"'
{"id":"sb_3tww4sm8fd","exit":0,"stdout":"3.12.3"}
{"id":"sb_xrnam6jvlw","exit":0,"stdout":"3.12.3"}
sb_xrnam6jvlw ready jq-demo-2
sb_3tww4sm8fd ready jq-demo-1
deleted sb_3tww4sm8fd
deleted sb_xrnam6jvlw