Skip to content
Browse documentation
Add data / ATH documentation

ath import

Preview and import provider exports or a complete v1 package.

Usage

$ath import ~/Downloads/export.zip

Arguments

<path>
Required. A complete v1 package, ZIP, extracted export folder, export.xml or supported vendor CSV.

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

Options

--file <path>
import into a database other than the one in this folder
-y, --yes
apply a conflict-free preview
--json
structured preview; never confirms the write

Related commands

Up nextath conflicts →