gpu-modelisted
Install: claude install-skill chipi/agentic-ai-homelab
# gpu-mode
The DGX has one GB10 GPU; the `coder-next` and `autoresearch` vLLMs can't both
hold it (both want ~90% of VRAM). `gpu-mode-swap.sh` is the authoritative
coordinator. This skill wraps it: **check freely, switch only on explicit go.**
## Connect
The script lives on the DGX host, symlinked at `~/bin/gpu-mode-swap.sh`. Reach it
over the tailnet with ssh (non-interactive → always the absolute path; the
`gpu-mode` zsh alias is not loaded in agent shells):
```bash
ssh dgx-llm-1 '~/bin/gpu-mode-swap.sh <args>'
```
## Check the mode — read-only, always safe
Before ANY local vLLM call, confirm the right stack owns the GPU:
```bash
ssh dgx-llm-1 '~/bin/gpu-mode-swap.sh --mode-only' # → code | research | idle | BROKEN-BOTH
ssh dgx-llm-1 '~/bin/gpu-mode-swap.sh status --json' # full machine-readable state
```
- **code** — coder-next up on `:9000`
- **research** — autoresearch up on `:8003`
- **idle** — both down; GPU free for ML training / Ollama
- **BROKEN-BOTH** — both listening (bad state); needs a human, do not pile on
If the mode already matches what you need, proceed. If not, see below — but do
not switch on your own.
## Switch the mode — SHARED-STATE, explicit approval required every time
Switching brings one vLLM up and the other down; it interrupts whatever is using
the GPU right now (a sweep, a training job, Ollama). Treat the DGX as production:
- Never switch as a side effect of "I need the endpoint." Ask first.
- `idle` does not mean the GPU is idle