# Athletic Standard

> An open standard and CLI for your training history. Keep your ath file wherever you choose, use the agent and model you choose, and carry your history across devices. ATH requires no account or subscription.

These docs cover ATH v0.4.3 (MIT license), reviewed against source commit cd89f72eceae3961ef1a05694226515c9e4321d2. They describe the CLI in that repository revision, its supported imports and the ath file format. Device independence does not imply an importer for every device. Supported device exports: Apple Health, WHOOP and Oura.

Checked 27 September 2026: v0.4.3 is available on npm.

The Markdown pages below are generated from the same content as the website. Start with SKILL.md for agent-led setup, then fetch the guides relevant to the task. The installed CLI's help and bundled skill are authoritative for its version.

## Agent setup

- [ATH skill](https://ath.fit/SKILL.md): Install ATH, create or locate the athlete's folder, install the bundled skill and verify setup.

## Start

- [Getting started](https://ath.fit/docs/index.md): ATH brings device measurements, workout results and your own observations into a local record that you and your agent can work from.
- [Your athletic record](https://ath.fit/docs/record.md): A readable index of your training, with the detail close at hand. Local files, open structure, explicit sources.
- [Working with agents](https://ath.fit/docs/agents.md): ATH is the record and the evidence layer. The model is yours to choose.

## Set up

- [ath init](https://ath.fit/docs/init.md): Create a record and install the agent skill.
- [ath skill](https://ath.fit/docs/skill.md): Check or refresh the instructions your agent uses.
- [ath --update](https://ath.fit/docs/update.md): Update ATH and refresh an existing agent skill in this folder.
- [ath key](https://ath.fit/docs/key.md): Manage a gateway key for predictions from the terminal.
- [ath models](https://ath.fit/docs/models.md): List available models or choose a default for predictions.

## Add data

- [ath import](https://ath.fit/docs/import.md): Load device exports into your record.
- [ath log](https://ath.fit/docs/log.md): Save a workout result, a measurement or a note.
- [ath link](https://ath.fit/docs/link.md): Attach a logged result to a device-recorded session.

## Read data

- [ath stats](https://ath.fit/docs/stats.md): See what is in your record.
- [ath series](https://ath.fit/docs/series.md): Read daily summaries or individual measurement samples.
- [ath check](https://ath.fit/docs/check.md): Validate the record and its sample files.

## Intelligence

- [ath predict](https://ath.fit/docs/predict.md): Predict a benchmark with a model, or prepare evidence for your agent.
- [ath grade](https://ath.fit/docs/grade.md): Record the outcome and compare it with a prediction.
- [ath backtest](https://ath.fit/docs/backtest.md): Replay past results to evaluate one or more models.
- [ath share](https://ath.fit/docs/share.md): Locate the latest backtest report. Sharing is not implemented yet.

## Reference

- [Command reference](https://ath.fit/docs/commands.md): Every ATH command, named the same way in the terminal, the sidebar and these guides.

## Optional

- [Complete documentation](https://ath.fit/llms-full.txt): All documentation pages in one Markdown document.
- [Website documentation](https://ath.fit/docs/): The same guides in HTML.
- [Format specification](https://github.com/mwhitham/ath/blob/cd89f72eceae3961ef1a05694226515c9e4321d2/SPEC.md): Version-pinned format reference.
- [Source repository](https://github.com/mwhitham/ath): Implementation and development history.