stravacli

name	stravacli
description	Use the stravacli terminal tool to access Strava data (athlete profile, activities, streams, routes, segments, clubs, gear, uploads) and perform limited write actions (activity update/upload). Trigger when the user asks for Strava metrics/history/exports or wants Strava automation via CLI.

stravacli

Use stravacli for Strava operations from terminal.

Setup

• Ensure binary is available in PATH: stravacli --version
• 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

Read commands (preferred by default)

• 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

Write commands (ask/confirm first)

• 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.

Output conventions

• 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.