---
name: xiangyue-zhang/gpu-monitor
source: https://app.decimal.ai/s/xiangyue-zhang-gpu-monitor@1/SKILL.md
source_sha256: a927f1255171
---

# gpu-monitor

Quick GPU status check for experiment management.

## Usage

```
Claude Code: /gpu-monitor
Claude Code: /gpu-monitor --server user@remote-host
Codex: $gpu-monitor
```

## Behavior

1. Run `nvidia-smi` to get current GPU status
2. Display a clean summary table:
   - GPU ID, Name, Memory (used/total), Utilization %, Temperature
   - Running processes on each GPU
3. Identify which GPUs are free (< 1GB memory used)
4. Identify which GPUs are running experiments (check for python/torchrun processes)
5. If `--server` is provided, SSH to remote server first

## Output Format

```
GPU Status
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 GPU  Name          Memory         Util  Temp
  0   L20X 144GB    45123/147456   98%   72°C  ← training (PID 12345)
  1   L20X 144GB      234/147456    0%   35°C  ← FREE
  2   L20X 144GB    43210/147456   95%   70°C  ← training (PID 12346)
  3   L20X 144GB     1024/147456   12%   40°C  ← keeper

Free GPUs: [1]
Training: GPU 0 (PID 12345), GPU 2 (PID 12346)
```