colab-harnesslisted
Install: claude install-skill apresmoi/skills
# colab-harness
A Colab GPU runtime becomes a job server reachable from here. Colab has no
API to start a runtime, so one click stays manual (or is done through the
Claude in Chrome extension); everything after that is HTTP through a tunnel.
```
you: Run all (once per session) ─→ Colab: job server + cloudflared ─→ prints the URL
│
local: node colab.mjs connect <url> ←───────────────────────────────────┘
node colab.mjs pipeline / transcribe / diarize / youtube / vllm / script / run
```
All commands live in `scripts/colab.mjs`. Run `node colab.mjs --help` for
flags. Each task below has one recipe; read only the one you need.
| Task | Recipe |
|---|---|
| First-time setup: the shared token as a Colab secret | `recipes/setup-token.md` |
| Gated Hugging Face models (Gemma, pyannote): HF_TOKEN and terms | `recipes/setup-hf.md` |
| YouTube downloads: the cookie file | `recipes/setup-youtube-cookies.md` |
| Start a session, connect, keep it alive, release it, run several | `recipes/session.md` |
| Transcribe, diarize, download from YouTube, the one-command pipeline | `recipes/transcribe-diarize.md` |
| Serve a model with vLLM and use it from any OpenAI client | `recipes/vllm.md` |
| Run a script on the VM: LoRA training, DSPy compile, anything | `recipes/train-and-scripts.md` |
## Hard rules for an agent
1. **Never type a credential into Colab or read one off a page.** The
harness token is pasted