whoop

# WHOOP API

Retrieve and analyze fitness data from WHOOP wearables via the official REST API.

## Usage Snippet
```bash
# Install (if using Clawdhub)
clawdhub install whoop-tracker

# From the skill root:
python3 scripts/get_recovery.py --today
python3 scripts/get_sleep.py --last
python3 scripts/get_workouts.py --days 7
python3 scripts/get_profile.py
```

## Prerequisites

- Python 3.7+
- `requests` library: `pip3 install requests`  
  (or run `bash scripts/install.sh`)

## Quick Start

### 1. Register Application
- Go to https://developer.whoop.com
- Create a new app and note your `client_id` and `client_secret`
- Set redirect URI (e.g., `http://localhost:8080/callback`)

### 2. Save Credentials
```bash
mkdir -p ~/.whoop
cat > ~/.whoop/credentials.json <<EOF
{
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET"
}
EOF
chmod 600 ~/.whoop/credentials.json
```

### 3. Authorize (see [references/oauth.md](references/oauth.md) for full guide)
- Open the authorization URL in browser
- User grants permissions → redirected with code
- Exchange code for tokens via `WhoopClient.authenticate(code, redirect_uri)`

### 4. Fetch Data
All scripts are run from the skill root directory:

```bash
# Today's recovery
python3 scripts/get_recovery.py --today

# Last night's sleep
python3 scripts/get_sleep.py --last

# Recent workouts
python3 scripts/get_workouts.py --days 7

# User profile
python3 scripts/get_profile.py
```

## Core Data Types

### Recovery
- **Recovery Score** (0-100): Readiness for strain
- **HRV (RMSSD)**: Heart rate variability in milliseconds
- **Resting Heart Rate**: Morning baseline HR
- **SPO2**: Blood oxygen percentage
- **Skin Temperature**: Deviation from baseline in °C

### Sleep
- **Performance %**: How well you slept vs. your sleep need
- **Duration**: Total time in bed and per stage (REM, SWS, light, awake)
- **Efficiency %**: Time asleep / time in bed
- **Consistency %**: How consistent your sleep schedule is
- **Respiratory Rate**:...