whoopskill

What this skill does

# whoopskill

Use `whoopskill` to fetch WHOOP health metrics (sleep, recovery, HRV, strain, workouts).

Install: `npm install -g whoopskill` | [GitHub](https://github.com/koala73/whoopskill)

Quick start
- `whoopskill summary` — one-liner: Recovery: 52% | HRV: 39ms | Sleep: 40% | Strain: 6.7
- `whoopskill summary --color` — color-coded summary with 🟢🟡🔴 status indicators
- `whoopskill trends` — 7-day trends with averages and direction arrows
- `whoopskill trends --days 30 --pretty` — 30-day trend analysis
- `whoopskill insights --pretty` — AI-style health recommendations
- `whoopskill --pretty` — human-readable output with emojis
- `whoopskill recovery` — recovery score, HRV, RHR
- `whoopskill sleep` — sleep performance, stages
- `whoopskill workout` — workouts with strain
- `whoopskill --date 2025-01-03` — specific date

Analysis commands
- `summary` — quick health snapshot (add `--color` for status indicators)
- `trends` — multi-day averages with trend arrows (↑↓→)
- `insights` — personalized recommendations based on your data

Data types
- `profile` — user info (name, email)
- `body` — height, weight, max HR
- `sleep` — sleep stages, efficiency, respiratory rate
- `recovery` — recovery %, HRV, RHR, SpO2, skin temp
- `workout` — strain, HR zones, calories
- `cycle` — daily strain, calories

Combine types
- `whoopskill --sleep --recovery --body`

Auth
- `whoopskill auth login` — OAuth flow (opens browser)
- `whoopskill auth status` — check token status
- `whoopskill auth logout` — clear tokens

Notes
- Output is JSON to stdout (use `--pretty` for human-readable)
- Tokens stored in `~/.whoop-cli/tokens.json` (auto-refresh)
- Uses WHOOP API v2
- Date follows WHOOP day boundary (4am cutoff)
- WHOOP apps with <10 users don't need review (immediate use)

Sample: `whoopskill summary --color`
```
📅 2026-01-25
🟢 Recovery: 85% | HRV: 39ms | RHR: 63bpm
🟡 Sleep: 79% | 6.9h | Efficiency: 97%
🔴 Strain: 0.1 (optimal: ~14) | 579 cal
```

Sample: `whoopskill trends`
```
📊 7-Day Trends

💚 Recovery: 62.1% avg (34-86) →
💓 HRV: 33.8ms avg (26-42) →
❤️ RHR: 63.8bpm avg (60-68) →
😴 Sleep: 75.4% avg (69-79) →
🛏️ Hours: 6.5h avg (5.7-7.8) ↓
🔥 Strain: 5.9 avg (0.1-9.0) ↓
```

Sample: `whoopskill insights`
```
💡 Insights & Recommendations

✅ Green Recovery
   Recovery at 85% — body is primed for high strain.
   → Great day for intense training or competition.

✅ HRV Above Baseline
   Today's HRV (39ms) is 21% above your 7-day average.
   → Excellent recovery. Good day for peak performance.

⚠️ Mild Sleep Debt
   You have 2.0 hours of sleep debt.
   → Consider an earlier bedtime tonight.

✅ Strain Capacity Available
   Current strain: 0.1. Optimal target: ~14.
   → Room for 13.9 more strain today.
```

Sample: `whoopskill --sleep --recovery` (JSON)
```json
{
  "date": "2026-01-05",
  "fetched_at": "2026-01-05T13:49:22.782Z",
  "body": {
    "height_meter": 1.83,
    "weight_kilogram": 82.5,
    "max_heart_rate": 182
  },
  "sleep": [
    {
      "id": "4c311bd4-370f-49ff-b58c-0578d543e9d2",
      "cycle_id": 1236731435,
      "user_id": 245199,
      "created_at": "2026-01-05T00:23:34.264Z",
      "updated_at": "2026-01-05T02:23:54.686Z",
      "start": "2026-01-04T19:51:57.280Z",
      "end": "2026-01-05T01:30:48.660Z",
      "timezone_offset": "+04:00",
      "nap": false,
      "score_state": "SCORED",
      "score": {
        "stage_summary": {
          "total_in_bed_time_milli": 20331380,
          "total_awake_time_milli": 4416000,
          "total_light_sleep_time_milli": 6968320,
          "total_slow_wave_sleep_time_milli": 4953060,
          "total_rem_sleep_time_milli": 3994000,
          "sleep_cycle_count": 4,
          "disturbance_count": 4
        },
        "sleep_needed": {
          "baseline_milli": 26783239,
          "need_from_sleep_debt_milli": 6637715,
          "need_from_recent_strain_milli": 148919
        },
        "respiratory_rate": 14.12,
        "sleep_performance_percentage": 40,
        "sleep_consistency_percentage": 60,
        "sleep_efficiency_percentage": 78.28
      }
    }
  ],
  "workout": [
    {
      "id": "4279883e-3d23-45cd-848c-3afa28dca3f8",
      "user_id": 245199,
      "start": "2026-01-05T03:14:13.417Z",
      "end": "2026-01-05T04:06:45.532Z",
      "sport_name": "hiit",
      "score_state": "SCORED",
      "score": {
        "strain": 6.19,
        "average_heart_rate": 108,
        "max_heart_rate": 144,
        "kilojoule": 819.38,
        "zone_durations": {
          "zone_zero_milli": 167000,
          "zone_one_milli": 1420000,
          "zone_two_milli": 1234980,
          "zone_three_milli": 330000,
          "zone_four_milli": 0,
          "zone_five_milli": 0
        }
      }
    }
  ],
  "profile": {
    "user_id": 245199,
    "email": "[email protected]",
    "first_name": "John",
    "last_name": "Doe"
  },
  "recovery": [
    {
      "cycle_id": 1236731435,
      "sleep_id": "4c311bd4-370f-49ff-b58c-0578d543e9d2",
      "user_id": 245199,
      "score_state": "SCORED",
      "score": {
        "recovery_score": 52,
        "resting_heart_rate": 60,
        "hrv_rmssd_milli": 38.87,
        "spo2_percentage": 96.4,
        "skin_temp_celsius": 33.19
      }
    }
  ],
  "cycle": [
    {
      "id": 1236731435,
      "user_id": 245199,
      "start": "2026-01-04T19:51:57.280Z",
      "end": null,
      "score_state": "SCORED",
      "score": {
        "strain": 6.66,
        "kilojoule": 6172.94,
        "average_heart_rate": 71,
        "max_heart_rate": 144
      }
    }
  ]
}
```