Keep

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.

zhijunio f0e0763 5 files · 25.7 KB Updated

File contents

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 --full export

Hard rules

  1. Credentials via env or CLI — never repeat passwords in chat or logs.
  2. Set --output explicitly in this repo (default path targets Jekyll site layout).
  3. Preserve running.json key names for downstream Garmin consumers.

Workflow

  1. Read references/usage.md for env, flags, output shape.
  2. Run script; use --limit 1 --debug on first API/field issues.
  3. 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

zhijunio/skills/tree/main/keep commit f0e07633ea

Frequently asked questions

npx skillmds@latest add zhijunio/keep