# ath grade

> Record the outcome and compare it with a prediction.

Website: https://ath.fit/docs/grade/
Markdown: https://ath.fit/docs/grade.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 grade fran --actual 4:32
```

## Arguments

| Argument or option | Description |
| --- | --- |
| `<benchmark>` | Required benchmark ID for the attempt being graded. |

## What it does

Previews the result, then saves it and grades an open prediction. Without an open prediction it records the result. An existing matching result can be graded without adding a duplicate.

## Examples

Use a clock time for timed efforts, a number for repetitions, or a load such as 100kg. --date selects an earlier attempt. --again is for a genuine second attempt that day. An agent can attach its explanation of a miss with --analysis after reviewing the returned evidence.

```text
ath grade fran --actual 4:32 --dry-run
```

## Options

| Argument or option | Description |
| --- | --- |
| `--actual <score>` | what happened: 4:32 for a time, 245 for reps, 100kg for a load |
| `--date <date>` | the day of the attempt, as YYYY-MM-DD. Leave it off for today |
| `--scaling <rx\|scaled>` | whether the workout was done as written, or scaled |
| `--analysis <json>` | the agent's write-up of a miss, after it has read the dossier |
| `--file <path>` | change a file other than the one in this folder |
| `-y, --yes` | write it without asking — for scripts, and when you are sure |
| `--again` | record a second attempt on a day that already has a result |
| `--dry-run` | show what would be written, and write nothing |
| `--json` | structured output, for an agent rather than a person |

## Related commands

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