Commands Reference

Every FitOps feature is a CLI command. This is the complete reference.

FitOps commands are grouped by function. Each group covers a distinct part of your training data — syncing it, querying it, analysing it, or planning against it.

Command Groups

Group	What it does
auth	Connect and manage your Strava account via OAuth
sync	Pull activities and time-series streams from Strava to your local DB
activities	Import GPX/TCX files and browse, publish, filter, or inspect activities
browser	Configure the logged-in Brave, Chrome, or Edge profile used for Strava publishing
athlete	Athlete profile, cumulative stats, equipment, and Strava zones
analytics	Training load (CTL/ATL/TSB), VO2max, HR zones, pace zones, trends, performance, power curves
weather	Fetch historical weather per activity, compute WAP factors, get race-day forecasts
workouts	Define structured workouts, link them to activities, score compliance, and analyse workout-specific load contribution
race	Import GPX/TCX courses, generate per-km pacing plans with elevation and weather, simulate pacer strategy
notes	Markdown training journal — create, tag, link to activities, and query across sessions
backup	Back up your entire FitOps data directory to GitHub and restore it on any machine
webhooks	Configure Strava webhook sync for event-driven activity updates
dashboard	Launch the local web dashboard

Getting Around

fitops --help                    # all command groups
fitops <group> --help            # commands in a group
fitops <group> <cmd> --help      # options for a specific command

Output — Rich by Default

Commands print rich, readable output by default — formatted tables, plain-language summaries, and labelled values. This is what you see at the terminal day-to-day.

fitops activities list

  ID            Date        Sport   Dist      Duration  Pace/Speed  HR
 ──────────────────────────────────────────────────────────────────────
  17972016511   2026-04-04  Run     12.12 km  58:05     4:47/km     168
  17951234567   2026-04-02  Run     8.50 km   40:10     4:43/km     162

Add --json to get raw JSON for scripting or piping to an AI agent:

fitops activities list --json

Mode	How	When to use
Rich (default)	Formatted table / summary	Day-to-day use, terminal browsing
JSON	--json flag	Scripting, piping to AI agents, automation

Errors are printed to stderr with a non-zero exit code.

Typical Workflows

Check your fitness right now:

fitops analytics training-load --today
fitops analytics snapshot

Explore a specific run:

fitops activities list --sport Run --limit 10
fitops activities get 17972016511

Configure zones and analytics:

fitops analytics zones --infer           # detect from your HR stream data
fitops analytics vo2max                  # estimate from recent hard efforts

Plan for a race:

fitops race import berlin.gpx --name "Berlin Marathon 2026"
fitops race simulate 1 --target-time 3:15:00 --date 2026-09-29 --hour 9

Open the visual dashboard:

fitops dashboard serve                   # → http://localhost:8888

See Output Examples for sample output from every command group.

← Back to Docs Home