dev-tpu-ray

# Skill: Legacy Ray Dev TPU Use this skill only when you specifically need the legacy Ray-backed dev TPU workflow. Prefer `.agents/skills/dev-tpu/SKILL.md` for the current Iris-backed path. `scripts/ray/dev_tpu.py` can reserve a temporary TPU VM, sync the repo, and run commands remotely. It is good for: - quick test and benchmark loops, - memory debugging, - profiling and trace capture, - short experiments where you want direct shell access. It is a bad fit for long unattended experiments or many concurrent TPU commands. ## Critical concurrency rule Run at most one TPU job at a time on a given dev TPU VM. Do not launch concurrent TPU commands from separate shells, tmux panes, or background jobs against the same dev TPU. ## Commands - `allocate`: reserve a TPU VM and keep it alive while the command runs. This also writes an SSH alias into `~/.ssh/config`. - `connect`: open an interactive shell on the TPU. - `execute`: sync local files to remote `~/marin/` unless `--no-sync`, then run one command. - `watch`: rsync + restart on local file changes. ## Prerequisites 1. Authenticate to GCP and set up the Marin development environment. ```bash gcloud auth login gcloud config set project hai-gcp-models gcloud auth application-default login make dev_setup ``` 2. Ensure your SSH public key is in project metadata: `https://console.cloud.google.com/compute/metadata?resourceTab=sshkeys&project=hai-gcp-models&scopeTab=projectMetadata` ## Quick Start Allocate: ```bash RAY_...