# ath stats

> See what is in your record.

Website: https://ath.fit/docs/stats/
Markdown: https://ath.fit/docs/stats.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 stats
```

## Arguments

| Argument or option | Description |
| --- | --- |
| `[file]` | Optional record path. Defaults to the record in the current folder. |

## What it does

Reads counts, date coverage, sources, baselines and benchmark history. It does not modify the record.

## Examples

Start here to find benchmark names, source IDs and available measurements before using predict or series. To read a different record, pass its path as the optional positional argument.

```text
ath stats --json
```

## Options

| Argument or option | Description |
| --- | --- |
| `--json` | structured output, for an agent rather than a person |

## Related commands

- [ath series](https://ath.fit/docs/series/)
- [ath check](https://ath.fit/docs/check/)