# ath export

> Write a complete deterministic JSON package.

Website: https://ath.fit/docs/export/
Markdown: https://ath.fit/docs/export.md

ATH v1.0.0 · MIT license. Documentation source: [7cd6a09](https://github.com/mwhitham/ath/blob/7cd6a097dbf2a12c7ea8a319869d4e0bb0def96b/src/program.ts). If your installed version differs, check its command help.

Checked 18 October 2026: v1.0.0 is available on npm.

## Usage

```text
ath export ./athlete-backup
```

## What it does

Reads one stable database revision and writes current records, retained revisions, deletions, erasure markers, dense samples, provider import keys and permitted attachments. The manifest is written last.

SQLite remains the live record. The exported JSON package is a portable snapshot and does not stay synchronized. Use export instead of copying an open database in write-ahead-log mode.

## Repeatable snapshots

Export time is absent by default, so the same database revision and options produce byte-identical output. Supply a fixed --exported-at value only when the manifest needs one.

## Options

| Argument or option | Description |
| --- | --- |
| `--exported-at <timestamp>` | include this exact UTC export time in the manifest |
| `--file <path>` | export another database |
| `--json` | structured command result |