# ath log

> Save a workout result, a measurement or a note.

Website: https://ath.fit/docs/log/
Markdown: https://ath.fit/docs/log.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 log fran in 4:41 rx
```

## Arguments

| Argument or option | Description |
| --- | --- |
| `[entry...]` | Optional text to log. Omit it to paste multiline text and finish with Ctrl-D. |

## What it does

Parses supported scores, measurement names and ratings, then previews the entry before saving. Unrecognised language stays as a note. Hand-entered measurements remain marked as manual.

## Examples

For a multiline workout, run ath log without text, paste the session and finish with Ctrl-D. An image-capable agent can read a whiteboard, notebook, PDF or coach’s message; the CLI itself does not read images. In chat, “log this 4:41 rx” is enough once the agent has the workout and the skill.

```text
ath log sore quads 4/5
ath log fran in 4:41 rx --date 2026-09-04 --dry-run
```

## Options

| Argument or option | Description |
| --- | --- |
| `--benchmark <name>` | name the workout yourself, instead of naming it after the day |
| `--date <date>` | the day it happened, as YYYY-MM-DD. Leave it off for today |
| `--scaling <rx\|scaled>` | whether the workout was done as written, or scaled |
| `--file <path>` | write to 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 result on a day that already has one |
| `--dry-run` | show what would be written, and write nothing |
| `--json` | structured output, for an agent rather than a person |

## Related commands

- [ath link](https://ath.fit/docs/link/)
- [ath grade](https://ath.fit/docs/grade/)