CLI Command Reference

Kinetiqo Click CLI Reference

Manage data synchronization, launch the Flask web server, inspect system readiness, and run database benchmarks directly from the command line.

`kinetiqo web`

Launches the async-enabled Flask web application and HTTP API server.

cli — web command

python src/kinetiqo.py web --host 0.0.0.0 --port 4444

`kinetiqo sync`

Triggers activity synchronization from the Strava API into your database.

cli — sync command

# Run fast incremental sync
python src/kinetiqo.py sync -q

# Run full history reconciliation
python src/kinetiqo.py sync -f

# Sync with a limited scope window (e.g. 7 days)
python src/kinetiqo.py sync -p 7d

# Skip Strava API limits by using local cache
python src/kinetiqo.py sync --enable-strava-cache --cache-ttl 60

# Force update all Strava descriptions without cache
python src/kinetiqo.py sync -f -U yes --clear-cache

`kinetiqo benchmark`

Measures raw parameterized SQL database performance across PostgreSQL, MySQL, and Firebird across 8 real-world analytical operations.

cli — benchmark command

# Benchmark last 365 days on PostgreSQL
python src/kinetiqo.py benchmark -s 365 -d postgresql

# Benchmark with custom scope and specific database backend
python src/kinetiqo.py benchmark --scope 30 --database mysql

# Benchmark Firebird backend
python src/kinetiqo.py benchmark -s 365 -d firebird

`kinetiqo flightcheck`

Verifies database connectivity, Strava OAuth token validity, and environment variable configuration.

cli — flightcheck command

python src/kinetiqo.py flightcheck

`kinetiqo scan-trophies`

Scans and backfills segment trophies (1st–10th place ribbons) from Strava activity segment efforts into the relational database and local verified trophies cache.

cli — scan-trophies command

# Scan up to 50 unscanned activities needing trophies
python src/kinetiqo.py scan-trophies --limit 50

# Scan with custom batch size and specific database backend
python src/kinetiqo.py scan-trophies -l 100 -d postgresql

`kinetiqo version`

Displays the current installed version of Kinetiqo.

cli — version command

python src/kinetiqo.py version

Global Options

These options can be applied before any subcommand to override default configurations.

--log-level Set the log verbosity (DEBUG, INFO, WARNING, ERROR, CRITICAL).
-d, --database-type Override the active database backend (postgresql, mysql, firebird).