fitfly-engine
Deterministic fitness coaching engine: adaptive programs, progression math, readiness autoregulation
Community: Submitted by a user or imported; check the owner before granting accessOnlineAPI key requiredGlobalFreeRead-only
What it can do
What data it sees
Do you need an account
An API key from the service settings is required
Deterministic fitness coaching engine: adaptive programs, progression math, readiness autoregulation
Server tool list (10)
Raw names from tools/list. Only developers need these.
| get_todays_session | Today's workout: exercises, sets/reps, per-exercise load guidance and concrete target weights, plus nutrition targets and cycle status. Auto-applies the user's readiness check-in (autoregulation) if they've done one today. Call this to see what the athlete should do now. |
| readiness_checkin | Record how the athlete feels today (energy, sleep, soreness — each 1–5). The engine scores readiness and, on the next get_todays_session, reshapes the workout accordingly (reduce volume / reduce intensity / recovery day). Returns the readiness score + modifier. |
| log_workout | Record what the athlete actually lifted. The engine runs progression (double-progression, e1RM), detects PRs, and returns per-exercise outcomes (established/progressed/held/deloaded) with next-time targets. Weights are in kg. |
| list_swap_options | Valid alternatives for an exercise — same muscle group, filtered to the athlete's equipment/level/injuries. Use before swap_exercise. |
| swap_exercise | Replace an exercise with a valid same-area alternative. scope 'today' = just this session; scope 'program' = going forward. The new lift starts fresh (day-one calibration). |
| get_program | The athlete's current multi-day program (render-ready). |
| regenerate_program | Rebuild the whole program from the stored profile (~20s AI generation). Use after a profile change or a plateau. |
| nutrition_targets | The athlete's daily calorie + macro targets, computed from body stats, activity, and goal. |
| meal_plan | A day of meals hitting the athlete's targets, USDA truth-checked (flags feasible=false with a note when macros are approximate). Slow (~15s AI call). |
| changelog | The 'what changed & why' feed — the engine's coaching decisions (volume bumps, deloads, swaps) in Coach Fly's voice. Use to explain to the athlete why their plan evolved. |