Ox

Plain text training log format and toolchain. Record training in .ox files, parse into structured data, analyze progress over time.

Inspired by Beancount (plain text accounting, but for training). Named after Milo of Croton.

Quick Start

Create training.ox:

2025-01-14 * pullups: 24kg 5/5/5

@session
2025-01-15 * Upper Volume
bench-press: 135lb 5x10
overhead-press: 85lb 4x10
pullup: BW 5x8
@end

2025-01-15 W 185lb T06:30 "home"

Run the CLI:

ox training.ox

Documentation

Full docs at konnerhorton.github.io/ox:

• Getting Started — first training log
• CLI Reference — commands and usage
• Reports & Plugins — built-in reports, plugin system
• API Reference — Python library
• Editor Support — VSCode extension, LSP, tree-sitter grammar

Syntax Overview

# Single-line entry
2025-01-14 * squat: 135lb 5x5 "felt good"

# Session block
@session
2025-01-15 * Lower Body
squat: 135lb 5x5
deadlift: 185lb 3x5
note: "easy day"
@end

# Weigh-in
2025-01-15 W 185lb T06:30 "home"

# Note
2025-01-15 note "deload week"

# Include another file
@include "other.ox"

# Movement definition
@movement squat
equipment: barbell
tags: squat, lower
note: back squat
@end

# Load a plugin
@plugin "plugins/my_plugin.py"

Flags: * completed, ! planned, W weigh-in

Weights: 24kg, 135lb, BW, 24kg+32kg (combined), 24/32/48kg (progressive, with implied units)

Reps: 5x5 (sets x reps), 5/3/1 (per-set)

Duration: ISO 8601 (PT30M, PT1H30M15S)

Distance: 5km, 3mi, 400m

Movement names: no spaces (kb-oh-press, bb-back-squat)

Installation

pip install ox

From source:

git clone https://github.com/konnerhorton/ox.git
cd ox
pip install -e .

Development

uv sync
uv run pytest
uv run ruff check src/ tests/

License

MIT — see LICENSE.