JSPM

trainerroad-cli

0.3.0
    • ESM via JSPM
    • ES Module Entrypoint
    • Export Map
    • Keywords
    • License
    • Repository URL
    • TypeScript Types
    • README
    • Created
    • Published
    • Downloads 4
    • Score
      100M100P100Q34907F
    • License ISC

    Unofficial CLI for authenticating with TrainerRoad and querying timeline/workout data

    Package Exports

    • trainerroad-cli
    • trainerroad-cli/src/cli.mjs

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (trainerroad-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    Unofficial TrainerRoad CLI

    Unofficial tool. Not affiliated with or endorsed by TrainerRoad.

    CLI to fetch TrainerRoad data for your account, including:

    • future workouts
    • past/completed workouts
    • today view
    • events and annotations
    • progression levels
    • plans and phases
    • FTP and FTP prediction
    • power ranking and power records
    • weight history

    It can also perform a small set of verified calendar writes for planned workouts:

    • search the workout library by zone/profile/search text/duration/level
    • fetch AI suggested workouts from TrainNow
    • recommend library workouts against target duration/level/TSS
    • fetch workout-library details by workout ID
    • add a library workout to a calendar date
    • copy an existing planned workout to another date
    • move a planned workout to a new date
    • list TrainerRoad alternate workout options
    • replace a workout with a specific alternate
    • switch a workout between inside and outside

    Agent-Friendly Behavior

    • Non-interactive by default. Inputs are flags or stdin, not prompts.
    • Progressive disclosure. Use trainerroad-cli help <command> or trainerroad-cli discover.
    • Command help includes concrete examples and flag descriptions.
    • Write commands support --dry-run previews.
    • Common retry cases are idempotent no-ops instead of duplicate calendar writes.

    Install

    Run without install (npx)

    npx --yes trainerroad-cli help

    Global install

    npm install -g trainerroad-cli
trainerroad-cli help

    Local project install

    npm install trainerroad-cli
npx trainerroad-cli help

    Local development (from source)

    git clone https://github.com/quinnsprouse/trainerroad-cli.git
cd trainerroad-cli
npm install
npm run help

    Quickstart

    1. Authenticate
    trainerroad-cli login --username <username> --password-stdin
    1. Query data
    trainerroad-cli whoami --json
trainerroad-cli today --json
trainerroad-cli future --days 30 --json
trainerroad-cli past --days 30 --json
trainerroad-cli plan --view current --json
trainerroad-cli levels --json
trainerroad-cli ftp --json
trainerroad-cli today --tz America/New_York --json
trainerroad-cli train-now --duration 60 --json
trainerroad-cli workout-library --zone "Endurance" --profile "Sustained Power" --min-duration 45 --max-duration 75 --json
trainerroad-cli workout-recommend --zone "Endurance" --profile "Sustained Power" --target-duration 60 --target-level 1.0 --count 3 --json
trainerroad-cli workout-details --id 18128 --include-chart --json
trainerroad-cli add-workout --workout-id 18128 --date 2026-03-16 --json
trainerroad-cli add-workout --workout-id 18128 --date 2026-03-16 --dry-run
trainerroad-cli copy-workout --id <planned-activity-id> --date 2026-03-16 --json
    1. Mutate planned workouts

    First get a planned workout ID from future --details:

    trainerroad-cli future --days 14 --details --json

    Then use that planned activity ID:

    trainerroad-cli workout-alternates --id <planned-activity-id> --category easier --json
trainerroad-cli move-workout --id <planned-activity-id> --to 2026-03-13 --dry-run
trainerroad-cli move-workout --id <planned-activity-id> --to 2026-03-13 --json
trainerroad-cli replace-workout --id <planned-activity-id> --alternate-id <workout-id> --json
trainerroad-cli switch-workout --id <planned-activity-id> --mode outside --json
trainerroad-cli copy-workout --id <planned-activity-id> --date 2026-03-16 --json

    copy-workout is the reliable way to place an existing planned workout on another date. add-workout exists, but TrainerRoad's add endpoints are still inconsistent and may fail even after retry/reconciliation.

    1. Discover all commands
    trainerroad-cli help
trainerroad-cli help future --json
trainerroad-cli discover --level 3 --json

    Modes

    • private (authenticated): full account data
    • public (username-based): limited day-level data

    Use --target <username> and/or --public for public mode queries.

    Output

    • default: pretty JSON
    • --json: structured JSON
    • --jsonl: one record per line
    • --fields a,b,c: project record fields
    • --records-only: lighter record payloads
    • --tz <IANA timezone>: localize day boundaries/timestamps (defaults to TR_TIMEZONE or system timezone)

    Help

    trainerroad-cli help
trainerroad-cli help future
trainerroad-cli future --help
trainerroad-cli help move-workout --json

    Security

    • Session cookies are stored in .trainerroad/session.json.
    • Treat this file as sensitive and do not commit it.