ath --update
Update ATH and refresh an existing agent skill in this folder.
Usage
Run it from your ath folder. --update is a top-level flag, so include both dashes.
v1.1.0 is the latest release on npm. These docs were reviewed against it on 8 November 2026.
$ath --updateWhat it does
Checks npm for the latest published version. For a global npm, pnpm or bun installation, it upgrades with the same package manager. An installation that is already current is left alone; a version ahead of npm is not downgraded.
It then refreshes the skill in the current folder if at least one installed copy exists. It does not create a missing skill or change athlete data.
After upgrading, run ath migrate when the CLI reports an outdated SQL schema, as it does for databases created by v1.0.0.
Older versions
Versions before v0.4.2 do not recognize --update. Rerun the install command you originally used, then check the version. For an npm installation:
This gets npm's latest published release, currently v1.1.0.
$npm i -g athleticstandard$ath --version$ath skill installMoving from 0.x to v1
v1 does not import prerelease 0.x ATH JSON documents. No automatic converter ships. Keep the old 0.x npm package to read legacy files, create a new v1 database, and re-import the original provider exports where possible.
Do not point v1 at athlete.ath.json and expect a migration. It reports the old file as unsupported and leaves it unchanged.
Other installations
For an npx, pnpm dlx or bunx copy, the command does not create a global installation. It can still refresh a skill that already exists in the current folder. The fetched CLI must support --update.
A project-local dependency or source checkout cannot update itself with this flag. Update through that project's package manager or source workflow instead; the command exits without changing the installation or skill.
Check the update
Check the version and skill status after updating. To refresh skill copies in other ath folders, run ath --update there too. Use ath skill install when you only need to install or refresh a skill.
If the registry check or package installation fails, the command reports the error and does not refresh the skill. Resolve the reported problem before retrying.
$ath --version$ath skill