Skip to content
Browse documentation
Set up / ATH documentation

ath init

Create a SQLite record and install the agent skill.

Usage

$ath init

What it does

Creates athlete.ath.sqlite in the current folder with an athlete profile, a manual source and standard benchmark definitions. Existing files are not overwritten. Use --empty only to make a destination for a complete v1 package restore.

Examples

Name, birth year and sex are optional. Stored measurements use metric units; --units changes display preferences. Save an IANA timezone when you want calendar calculations to use it by default. The skill is installed in .agents/skills and existing agent folders unless you pass --no-skill.

$ath init --name Mike --timezone America/Chicago
$ath init --yes --empty

Options

--name <name>
your name, so the file says whose it is
--birth-year <year>
birth year, which some readings are read against
--sex <sex>
male | female, for the same reason
--units <units>
metric | imperial — display only; stored values are always metric
--timezone <name>
default IANA timezone for calendar calculations
--file <path>
write somewhere other than the default name
-y, --yes
skip the questions and use the flags and defaults
--empty
create no athlete records, for restoring a complete v1 package
--no-skill
do not install the agent skill, even if an agent folder is here
--json
structured output, for an agent rather than a person

Related commands

Up nextath skill →