GRID(1)UP · spin
grid up
grid up <gridfile> [--region r,..] [--hold] [--tail]
nameLift a fleet from a single, declarative file.
descriptionReads a gridfile, requests boxes, runs your command across them, streams stdout to your terminal, then disappears. The fleet exists for as long as your job exists, no longer.
exits0 on clean teardown · 2 on partial failure · 17 if you forgot --region.
GRID(1)WATCH · stream
grid watch
grid watch <fleet-id> [--filter expr] [--since 1m]
nameTail a fleet without becoming its parent process.
descriptionMultiplexed stdout/stderr from every box, filterable by region, host, or arbitrary expressions. Survives your laptop closing. The fleet doesn't die when you leave.
see alsogrid attach(1), grid logs(1), tmux(1).
GRID(1)SCALE · resize
grid scale
grid scale <fleet-id> --to N [--in-region r]
nameGrow or shrink a running fleet without restarting the job.
descriptionAdds or releases boxes, redistributes work shards across the new shape, and keeps the global ordering of your output stream intact. Bills only the actual delta, by the second.
caveatShrinking past --min-quorum aborts in‑flight shards. Use --drain instead.
GRID(1)DOWN · release
grid down
grid down <fleet-id> [--force] [--receipt]
nameRelease a fleet, finalize the bill, mail you a receipt.
descriptionStops every box, persists final logs to /var/log/grid/<fleet-id>, and emits a signed receipt to your default address. Idempotent. Safe to retry.
noteFleets self‑terminate after their parent job exits. grid down is for when you panic.