Strava Activity CLI

Appearance

Configuration ​

This page details the configuration options and environment variables used by the Strava Activity CLI tool.

Environment Variables ​

The following environment variables need to be set in your .env file:

Required Variables ​

  • STRAVA_CLIENT_ID: Your Strava API application client ID
  • STRAVA_CLIENT_SECRET: Your Strava API application client secret

Authentication Storage ​

The CLI tool securely stores your authentication tokens using your system's keychain:

  • Access tokens are automatically refreshed when expired
  • Tokens are securely stored using the system keychain (via keytar)
  • No sensitive data is stored in plain text

Dependencies ​

The tool requires the following system dependencies:

  • Node.js (v20 or higher)
  • npm (Node Package Manager)

File Locations ​

  • .env: Root directory of the project
  • Authentication tokens: Secure system keychain

Best Practices ​

  1. Never commit your .env file to version control
  2. Keep your Strava API credentials secure
  3. Use the provided strava ping command to verify your configuration