ath log

Usage

$ath log fran in 4:41 rx

Arguments

[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.

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

Options

--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 ↗
• ath grade ↗