name: keep description: Log in via Keep Open API and fetch runs into Garmin-compatible running.json (VDOT, training load, period stats, optional per-km segments). Use for Keep run sync, fetch_keep_run, running.json, or exporting Keep running data.
Keep run sync
Pull Keep runs into Garmin-style running.json via scripts/fetch_keep_run.py.
Aligned with upstream fetch-keep-run.py — sync from there when updating behavior.
When to use
- User mentions Keep API,
running.json, VDOT, training load,fetch_keep_run.py - Incremental sync or
--fullexport
Hard rules
- Credentials via env or CLI — never repeat passwords in chat or logs.
- Set
--outputexplicitly in this repo (default path targets Jekyll site layout). - Preserve
running.jsonkey names for downstream Garmin consumers.
Workflow
- Read
references/usage.mdfor env, flags, output shape. - Run script; use
--limit 1 --debugon first API/field issues. - Report merge result (new runs count, output path) — not raw credentials.
Validation
python3 -m py_compile keep/scripts/fetch_keep_run.py
References
references/usage.md— CLI, credentials, output, debug