# ath models

> List available models or choose a default for predictions.

Website: https://ath.fit/docs/models/
Markdown: https://ath.fit/docs/models.md

ATH v0.4.3 · MIT license. Documentation source: [cd89f72](https://github.com/mwhitham/ath/blob/cd89f72eceae3961ef1a05694226515c9e4321d2/src/program.ts). If your installed version differs, check its command help.

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

## Usage

```text
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.

```text
ath models --gateway openrouter
```

## Options

| Argument or option | Description |
| --- | --- |
| `--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

- [ath key](https://ath.fit/docs/key/)
- [ath predict](https://ath.fit/docs/predict/)
- [ath backtest](https://ath.fit/docs/backtest/)