Repository navigation
v0.1.0 — first public release
A running coach that lives in your terminal: a plan-generating engine with a CLI and an MCP server. Your training plan is a YAML file in a git repository, every session cites the research behind it, and your agent gets the coach as a tool.
mkdir my-training && cd my-training && git init
npx trainctl init && npx trainctl plan && npx trainctl todayEngine. Macrocycle from base to taper with pyramidal-to-polarised progression; session shapes drawn from a corpus of 50 real coaching plans; zones calibrated from race results, never from a watch's threshold estimate; finish prediction as a range, never a single number; a week re-solver that names the session it sacrifices and why.
Interfaces. 16 CLI commands and 16 MCP tools over the same handlers, so the agent and the terminal cannot disagree. check lints the plan against the engine's invariants and fails a CI pipeline; diff --plan compares two full plans, so "what if I move the race three weeks" is a branch, not a rewrite. English and Polish, both first-class.
Where it refuses. No injury-risk score, no readiness from HRV, no silent edits to your own plan — each refusal documented against the literature in docs/science/FOUNDATIONS.md (~60 sources, rule IDs quoted by trainctl why).
Requires Node ≥ 22.18; there is no build step, so the published package is the source you can read. Architecture and decisions: SPEC.md. Full changelog: CHANGELOG.md.
Known limits are listed in the changelog rather than hidden: activities reaching intervals.icu through Strava carry no data through its API, long runs are always generated easy (71% of the corpus coach's), and the backtest calibrates VDOT to an engineering value rather than the athlete's own results.
Tag note: v0.1.0 was moved once, hours after it was first cut, to include a fix for export filenames dropping the Polish ł (interwa-y.fit → interwaly.fit). Nothing had been published under the tag at that point — the npm packages are not out yet — so the tag now matches exactly what will be published.