Skip to content
Browse documentation
Set up / ATH documentation

ath models

List available models or choose a default for predictions.

Usage

$ath models

What it does

Loads the live model catalog from your configured gateway. Listing models does not modify the record.

Examples

Copy a model ID from the list and pass it to --default to save your usual model beside the record, or to ath predict --model for a single run. With both gateways configured, select one with --gateway.

$ath models --gateway openrouter

Options

--default <name>
save this model next to the athlete file, for the next predict
--gateway <name>
vercel or openrouter, when both keys are available
--file <path>
the athlete file whose default to save
--json
structured output, for an agent rather than a person

Related commands

Up nextath import →