Getting started
ATH brings device measurements, workout results and your own observations into a local record that you and your agent can work from.
Set up with your agent
Give this prompt to an agent that can read the web and run commands in your chosen folder. It will follow the ATH setup guide and install the bundled agent skill. If your agent cannot run commands, follow the steps below.
Ask your agentread https://ath.fit/SKILL.md and follow the instructions to set up ath and its agent skill for me
Install ATH
You need Node.js 22 or newer. Install the LTS release from nodejs.org, then open Terminal on macOS or PowerShell on Windows.
v1.1.0 is the latest release on npm. These docs were reviewed against it on 8 November 2026.
Install the published npm package globally, or use npx athleticstandard in place of ath when a global install is unavailable.
SQL schema migration (ath migrate) and confirmed ath repair use the sqlite3 command-line tool for verified backups. Install sqlite3 and ensure it is on PATH before running either command.
$npm i -g athleticstandard$ath --versionCreate your record
Create a folder named ath-yourname, such as ath-mike or ath-jill. Replace ath-mike in the example below with your own folder name. Run later commands from that folder.
Name, birth year and sex are optional. Press Enter to skip any of them. ATH v1 creates athlete.ath.sqlite with a manual source and standard benchmark definitions.
$mkdir ath-mike$cd ath-mike$ath initPut something in it
Import a watch export, or log a result. ATH previews a logged entry before asking you to save it.
$ath import ~/Downloads/export.zip$ath log Fran in 4:41 rx$ath statsKeep it local
athlete.ath.sqlite is the live record. Dense samples also live in SQLite; there is no live series/ folder. Attachments remain ordinary sibling files.
Use ath export for a complete portable JSON snapshot. An export does not stay synchronized with the database. Keep the database and attachments on your machine or in storage you choose. ATH does not provide hosting, automatic synchronization or database encryption. Use operating-system disk encryption.
$ath export ./athlete-backupUpdate ATH
Run ath --update from your ath folder to update a global installation with the package manager you used and refresh an existing skill copy.
The command checks npm for the latest published release and leaves an installation that is already current alone. After upgrading, run ath migrate when the CLI reports an outdated SQL schema, as it does for databases created by v1.0.0.
$ath --update$ath --version