strava-cycling

# Strava Cycling Coach Track cycling performance, analyze rides, and monitor fitness progression using the Strava API. ## Setup ### 1. Create Strava API Application Visit https://www.strava.com/settings/api and create an application: - Application Name: Clawdbot (or your preferred name) - Category: Data Importer - Club: (leave blank) - Website: http://localhost - Authorization Callback Domain: localhost Save your **Client ID** and **Client Secret**. ### 2. Run Setup Script ```bash cd skills/strava ./scripts/setup.sh ``` You'll be prompted for: 1. Client ID 2. Client Secret 3. Visit an OAuth URL to authorize 4. Copy the authorization code and complete setup with: ```bash ./scripts/complete_auth.py YOUR_CODE_HERE ``` ### 3. Configure Automatic Monitoring (Optional) To receive automatic ride analysis after each workout: ```bash # Set your Telegram chat ID export STRAVA_TELEGRAM_CHAT_ID="your_telegram_chat_id" # Add to your shell profile for persistence echo 'export STRAVA_TELEGRAM_CHAT_ID="your_telegram_chat_id"' >> ~/.bashrc # Set up cron job (checks every 30 minutes) crontab -l > /tmp/cron_backup.txt echo "*/30 * * * * $(pwd)/scripts/auto_analyze_new_rides.sh" >> /tmp/cron_backup.txt crontab /tmp/cron_backup.txt ``` ### 4. Test the Setup Analyze your recent rides: ```bash ./scripts/analyze_rides.py --days 90 --ftp YOUR_FTP ``` ## Usage Get latest ride: ```bash scripts/get_latest_ride.py ``` Analyze specific ride: ```bash scripts/analyze_ride.py <activity-id> ``` Monitor for new rides (runs in background): ```bash scripts/monitor_rides.sh ``` ## Automatic Monitoring The skill can automatically: 1. Check for new rides every 30 minutes 2. Analyze power, heart rate, and training load 3. Send insights about performance and fitness trends 4. Compare to recent training history ## Metrics Analyzed - **Power**: Average, normalized, max, variability index - **Heart rate**: Average, max, time in zones - **Training load**: TSS estimation, intensity factor - **Fitness progression**: Trends over time - **Segments**: PR achievements and efforts - **Comparative**: vs recent rides, vs personal bests ## Configuration Edit `~/.config/strava/config.json` to customize: - Monitoring frequency - Analysis preferences - Notification settings ## API Reference See [references/api.md](references/api.md) for complete Strava API documentation.