stravacli

Use stravacli for Strava operations from terminal.

Prerequisites

This skill depends on the external CLI project:

Install stravacli before using this skill:

Recommended (release binary):
- Download latest from: https://github.com/Brainsoft-Raxat/strava-cli/releases/latest
Or with Go:
- go install github.com/Brainsoft-Raxat/strava-cli/cmd/stravacli@latest

Then verify binary is available in PATH:

Authenticate before data commands:
- Local: stravacli auth login
- Headless/VPS: stravacli auth login --remote, then complete with stravacli auth login --auth-url '<callback-url>'
Verify auth: stravacli auth status

Athlete profile: stravacli athlete me --json
Athlete stats: stravacli athlete stats --json
Athlete zones: stravacli athlete zones --json
List activities: stravacli activities list --per-page 10 --json
Activity details: stravacli activities get <id> --json
Activity laps: stravacli activities laps <id> --json
Activity streams: stravacli activities streams <id> --json
Routes list/get: stravacli routes list --json / stravacli routes get <id> --json
Export route file: stravacli routes export <id> --format gpx --out ./route.gpx
Segments/starred/explore: stravacli segments starred --json, stravacli segments explore --bounds <swlat,swlng,nelat,nelng> --json
Clubs: stravacli clubs list --json
Gear: stravacli gear get <id> --json
Upload status: stravacli uploads get <uploadId> --json

Update activity metadata: stravacli activities update <id> --name 'New name' --description '...'
Upload activity file: stravacli activities upload --file ./run.fit --yes --json

Always confirm intent before write actions.

Use --json when results need parsing or reuse.
Keep user summaries concise; include key metrics and IDs.
If a command fails with auth errors, suggest stravacli auth status then re-login.