rbtk pool
├── list                # List pools in the current project
├── create              # Create a new pool (self-hosted or hosted)
├── register-runner     # Mint a registration token for a self-hosted runner
├── runners             # List runners in a pool with status
├── stats               # Per-pool job throughput, queue wait, sim-minute usage
├── drain               # Stop accepting new jobs (graceful shutdown helper)
├── runner-revoke       # Invalidate one runner's token
└── delete              # Delete an empty pool

rbtk pool list

NAME                TYPE         SKU                 RUNNERS   STATUS    JOBS 24h
prod-gpu-farm       self-hosted  —                   4 online  OK        412
staging-gpu         self-hosted  —                   1 online  OK        87
fallback-gazebo     hosted       hosted-gazebo-gpu   —         OK        14
fallback-cpu        hosted       hosted-ros2-cpu     —         OK        211

# Self-hosted
rbtk pool create --name prod-gpu-farm --type self-hosted

# Hosted (Roboticks-operated)
rbtk pool create --name fallback-gazebo --type hosted --sku hosted-gazebo-gpu

rbtk pool register-runner --pool prod-gpu-farm
# Registration token: rbtk_pool_reg_xx... (valid 1h, single-use)

TOKEN=$(rbtk pool register-runner --pool prod-gpu-farm --output json | jq -r .token)
rbtk-runner register --pool prod-gpu-farm --token $TOKEN --name $(hostname)

rbtk pool runners --pool prod-gpu-farm
rbtk pool runners --pool prod-gpu-farm --watch    # auto-refresh every 5s

NAME           STATUS    JOBS      CAPABILITIES                          LAST HEARTBEAT
gpu-host-01    ONLINE    1/4       ros:humble,iron · sim:gazebo · gpu:T4 6s ago
gpu-host-02    ONLINE    3/4       ros:humble,iron · sim:gazebo · gpu:T4 9s ago
gpu-host-03    DRAINING  2/4       ros:humble       · sim:gazebo · gpu:T4 11s ago
gpu-host-04    OFFLINE   0/0       (last seen 2h ago)                    —

rbtk pool stats --pool prod-gpu-farm --since 24h
rbtk pool stats --pool fallback-gazebo --since 30d --output json

POOL               prod-gpu-farm (self-hosted, project: warehouse)
WINDOW             last 24h
JOBS               412 dispatched · 408 completed · 3 failed · 1 requeued
WALL TIME          17h 24m total · avg 152s
QUEUE WAIT         p50 1.2s · p95 7.4s · p99 22.1s
TOP REQUIREMENTS   ros:humble (231) · gazebo-harmonic (164) · gpu (164)

BILLED SIM MINUTES 1043 min (of 500 included → 543 min metered at $0.10/min = $54.30)

rbtk pool drain --pool prod-gpu-farm
# All 4 runners in prod-gpu-farm marked DRAINING.
# In-flight jobs: 5 — watch with: rbtk pool runners --pool prod-gpu-farm --watch

rbtk pool resume --pool prod-gpu-farm

rbtk pool runner-revoke --pool prod-gpu-farm --runner gpu-host-04

rbtk pool delete --pool old-staging-gpu
# Refused: pool has 1 ONLINE runner. Drain first.

rbtk pool drain --pool old-staging-gpu
# Wait for runners to go OFFLINE...
rbtk pool delete --pool old-staging-gpu --confirm

# Mint a long-lived multi-use token (Enterprise tier)
rbtk pool register-runner --pool prod-gpu-farm --ttl 24h --uses 50 \
  --output json | jq -r .token > /etc/roboticks/pool-token

# On each pod / instance startup:
rbtk-runner register --pool prod-gpu-farm \
  --token "$(cat /etc/roboticks/pool-token)" \
  --name "${HOSTNAME}-${POD_UID}"

# On shutdown:
rbtk-runner drain --timeout 110s