ath import
Preview and import provider exports or a complete v1 package.
Usage
$ath import ~/Downloads/export.zipArguments
What it does
Detects complete ATH v1 packages and Apple Health, WHOOP or Oura exports. The first run is always a preview; --json is also only a preview and never confirms a write.
Provider previews report new, matching, changed, skipped and conflicting records. Package previews report new, matching, changed and conflicting records, and list unknown fields and records that v1 cannot represent. Those block the write; no flag discards them.
Repeating an unchanged provider export reports matching records. Changed provider rows with the same import key create a retained revision. For a v1 package, an empty database adopts the package database ID and exact revision history. A database with the same ID can accept new records and later revisions; import never deletes a local record merely because a package omits it. A different database ID is refused.
Examples
Review the preview, then repeat the command with --yes to apply a conflict-free import. Unknown or unrepresentable package content blocks the write. A v1 package with conflicts uses ath conflicts before the final import. Athletic Standard 0.x JSON is refused.
$ath import ~/Downloads/export.zip$ath import ~/Downloads/export.zip --yes