Liftosaur

Delete a single recorded measurement value, identified by its key and timestamp (from list/get). Valid keys: weight, neck, shoulders, bicepLeft, bicepRight, forearmLeft, forearmRight, chest, waist, hips, thighLeft, thighRight, calfLeft, calfRight, bodyfat, sleep, calories, protein ('weight' is bodyweight, 'bodyfat' is a percentage, 'sleep'/'calories'/'protein' are read-only daily health imports, the rest are body lengths). For the health keys, whose records are imported from Apple Health / Health Connect, deleting hides the record instead of removing it: it disappears from all reads and stays hidden across re-imports, and can be unhidden from the app's Sleep & Nutrition screen.

delete_measurement

Delete a program by ID. Cannot delete the currently active program.

delete_program

Delete a workout history record by ID.

delete_history_record

Get the Liftohistory format reference. Liftohistory is a human-readable text format for workout history records used by Liftosaur. Call this if you need to create or edit history records and are unsure about the format.

get_liftohistory_reference

Get complete Liftoscript program examples. Call this after get_liftoscript_reference to see full working programs demonstrating various features (linear progression, 5/3/1, GZCL, PPL, etc.).

get_liftoscript_examples

Get the Liftoscript language reference. Liftoscript is a custom DSL for defining weightlifting programs in Liftosaur — it is NOT a standard format and you cannot guess the syntax. You MUST call this BEFORE creating or editing any program. The reference covers: exercise syntax, sets/reps/weight notation, progressions (lp, dp, custom), templates, multi-week programs, state variables, supersets, warmups, and common mistakes to avoid. After reading this, also call get_liftoscript_examples for complete program examples.

get_liftoscript_reference

Get a built-in program's full markdown file — includes description and Liftoscript source code. Use this to see how real programs are written.

get_builtin_program

Get a single custom exercise by ID.

get_custom_exercise

Get a single equipment's full configuration (bar weights, plates, fixed weights, multiplier, unit) within a gym.

get_equipment

Get the customized settings for a single exercise key (e.g. 'squat_barbell', 'benchPress_barbell'). Returns 404 if the exercise has no customizations stored. Use list_exercises for valid built-in exercise ids and list_custom_exercises for custom ones.

get_exercise_data

Get the recorded history for a single measurement key, newest-first, paginated. Valid keys: weight, neck, shoulders, bicepLeft, bicepRight, forearmLeft, forearmRight, chest, waist, hips, thighLeft, thighRight, calfLeft, calfRight, bodyfat, sleep, calories, protein ('weight' is bodyweight, 'bodyfat' is a percentage, 'sleep'/'calories'/'protein' are read-only daily health imports, the rest are body lengths). Returns up to 'limit' values plus 'hasMore' and 'nextCursor'; pass 'nextCursor' back as 'cursor' to fetch the next (older) page. An empty list means nothing has been recorded for that key yet.

get_measurement

Get a program's full source in Liftoscript format. Use id="current" to get the currently active program. Liftoscript is a custom DSL for weightlifting programs — call get_liftoscript_reference for the language guide.

get_program

Get the evidence-based program design guide: weekly volume targets per muscle group, intensity and rep ranges, progression schemes, splits by days per week, deloads, and calisthenics — mapped to Liftoscript constructs and get_program_stats semantics. Call this BEFORE designing a program from scratch (e.g. "make me a 3-day hypertrophy program") so the program hits effective volume and progression targets. Do NOT use it when transcribing a published program (5/3/1, GZCLP, etc.) — transcribe those faithfully.

get_program_design_guide

Retrieve workout history records in Liftohistory text format. Example record: ``` 2026-02-28T10:45:30Z / program: "5/3/1" / dayName: "Push Day" / week: 1 / dayInWeek: 5 / duration: 1235s / exercises: { Bench Press, Barbell / 3x8 185lb @7, 1x6 185lb @9 / warmup: 1x10 95lb / target: 3x8-12 185lb @8 90s } ``` Use startDate/endDate (ISO dates or unix timestamps) to filter by date range. Use limit/cursor for pagination (max 200 per page).

get_history

Get a single workout history record by ID. Returns the record in Liftohistory text format.

get_history_record

List all built-in exercise names available in Liftosaur. Use this to find the correct exercise name and equipment variant (e.g. 'Standing Calf Raise' instead of 'Calf Raise', or 'Bicep Curl, Barbell' instead of 'Barbell Curl').

list_exercises

List all built-in Liftosaur programs with their id and name.

list_builtin_programs

List the user's custom exercises. Returns id, name, target muscles, synergist muscles, and types for each. Use limit/cursor for pagination (max 200 per page).

list_custom_exercises

List all of a gym's equipment, including soft-deleted ones (each carries an isDeleted flag). Equipment configuration (bar weight, available plates, fixed weights) drives how Liftosaur rounds prescribed weights during a workout. Built-in equipment keys: barbell, cable, dumbbell, smith, band, kettlebell, bodyweight, leverageMachine, medicineball, ezbar, trapbar. Custom equipment has keys like 'equipment-xxxxxxxx'. Call list_gyms first to get the gymId.

list_equipment

List all per-exercise settings the user has customized (1 rep max, weight rounding, per-gym equipment overrides, notes, muscle overrides, unilateral flag). Each entry is keyed by an exercise key: a built-in exercise id joined with its equipment by '_' (e.g. 'squat_barbell', 'benchPress_barbell'), or a custom exercise id. Exercises without any customization don't appear here — that's expected; their values fall back to defaults. Use this to discover the exact keys already in use before writing with set_exercise_data.

list_exercise_data

List the user's gyms. Equipment (bars, plates, etc.) is configured per gym, so you need a gym's id before reading or editing its equipment. Returns id, name, whether it's the current gym, and equipment count. Most users have a single gym.

list_gyms

Overview of the user's tracked body measurements and daily health metrics. Each measurement is keyed by name and falls in one of four categories: weight (`weight` = bodyweight, in kg/lb), percentage (`bodyfat`, in %), length (a body part, in cm/in), or health (`sleep` in minutes per night, `calories` in kcal/day, `protein` in g/day — read-only daily aggregates imported from Apple Health / Health Connect, timestamped at local midnight of the day they belong to; sleep is bucketed to the wake day). Returns, per key that has data, the total `count` of recorded values and the `latest` one (with its unix epoch ms `timestamp`, an ISO 8601 `date`, and a unit-suffixed `value` like "180lb" or "432min"). Keys with no recorded values are omitted. This does NOT return the full series — a key can have thousands of values; page through them with get_measurement.

list_measurements

List all user's programs. Returns id, name, and whether each is the currently active program.

list_programs

Set (upsert) per-exercise settings for an exercise key like 'squat_barbell' or 'benchPress_barbell'. Use this to set a user's 1 rep max (rm1), weight rounding, per-gym equipment overrides, notes, muscle overrides, or the unilateral flag. Only provided fields change; omitted fields keep their current values; pass null for a field to clear it (revert to default). The key's exercise must exist (built-in id from list_exercises, joined with its equipment by '_', or a custom exercise id). Prefer the equipment-qualified key that matches how the user trains — a bare built-in id only matches the no-equipment variant and won't affect normal barbell/dumbbell entries.

set_exercise_data

Simulate a workout to validate program logic and test progressions. Returns the workout in Liftohistory format. Optionally pass commands to simulate user actions: - complete_set(exercise, set) — mark a set done (1-indexed) - change_weight(exercise, set, weight) — e.g. change_weight(1, 1, 185lb) - change_reps(exercise, set, reps) - change_rpe(exercise, set, rpe) - change_set_time(exercise, set, seconds) — for timed (isometric hold) sets; complete_set already records the held time as the programmed duration, use this to override it - set_state_variable(exercise, name, value) - finish_workout() — runs all progression scripts, returns updatedProgramText Use this to verify a program works correctly before saving with create_program or update_program. IMPORTANT: You MUST call get_liftoscript_reference BEFORE writing programText. If you get parse errors, call get_liftoscript_reference and try again.

run_playground

Update an existing custom exercise. Only provided fields are changed; omitted fields keep their current values. See create_custom_exercise for available muscles and types.

update_custom_exercise

Update a gym's equipment. Only provided fields change; omitted fields keep their current values. Weights are strings like "45lb" or "20kg". Out-of-range values are clamped. Works for built-in and custom equipment. To soft-delete or restore equipment, set the isDeleted field (true removes it from workout pickers — the config is kept — false restores it).

update_equipment

Rename a gym and/or make it the current (active) gym.

update_gym

Update an existing program's Liftoscript source code. Use id="current" to update the active program. IMPORTANT: You MUST call get_liftoscript_reference BEFORE using this tool. Liftoscript is a custom DSL with specific syntax — programs written without reading the reference will have errors. Use run_playground to validate before saving. When redesigning a program's structure (volume, splits, progressions) rather than making a targeted edit, also call get_program_design_guide for volume, intensity, and progression targets. Before writing the program, call list_custom_exercises to check for existing custom exercises. Reuse them by name instead of creating duplicates — this preserves workout history.

update_program

Update an existing workout history record. The text must be a single workout record in Liftohistory format.

update_history_record

Change the reading of an existing measurement value, identified by its key and timestamp (from list/get). Valid keys: weight, neck, shoulders, bicepLeft, bicepRight, forearmLeft, forearmRight, chest, waist, hips, thighLeft, thighRight, calfLeft, calfRight, bodyfat ('weight' is bodyweight, 'bodyfat' is a percentage, the rest are body lengths). The timestamp is the entry's identity and can't be changed here — to re-date an entry, delete_measurement it and add_measurement it at the new time.