# Workout Builder — NexCoach

> Workout Builder lets trainers create, edit, schedule, assign, and manage client workout plans.

- Page: <https://nexcoach.fit/feature/ai-workout-builder>
- App location: `/trainer/workout-plans`
- Used by: Trainers
- Availability: Available to all trainers during early access (free, no card required). See https://nexcoach.fit/pricing.
- Last verified: 2026-10-11

## What it does

- Lists workout plans with search, pagination, view, edit, and delete actions.
- Creates plans for a selected client using weekly or date-based scheduling.
- Supports plan names, training days, exercises, sets, reps, rest times, notes, YouTube URLs, and weight units.
- Provides an exercise library with Search, Recently Used, Frequently Used, Custom, and Create New tabs.
- Supports catalog exercise details, drag-to-add, and custom exercise creation.
- Groups exercises into Supersets and Circuits, with labels, rest settings, ordering, members, and circuit rounds.
- Copies selected exercises between workout days and supports adding, removing, moving, editing, grouping, and ungrouping exercises.
- Provides optional Progressive Overload with automatic or interval progression, increments, and units.
- Generates a workout draft with AI using equipment, session length, split, focus, injuries, variety, cardio, compound experience, and units. AI generation replaces the current open draft.
- Shows plan detail pages with days, exercises, sets, reps, weights, and group labels.

## How it works

1. Open `/trainer/workout-plans` and choose `Create Workout Plan`.
2. Select a client.
3. Choose `Plan by Week` or `Plan by Date`. Weekly plans repeat on selected weekdays. Date plans use a calendar with a separate workout-building modal for each selected date, and each date can have its own workout.
4. For weekly plans, choose a ready-made template or start from scratch, then configure the plan name and `Workout Days`. Date plans use the calendar flow.
5. In the builder, add exercises from the library or choose `Add Exercise`.
6. In the exercise form, enter `Exercise Name`, configure equipment and sets, add `Rest Between Sets`, optional `Notes`, and an optional `YouTube URL`, then choose `Add to Workout`.
7. Select an exercise to edit it, move it, remove it, copy it to another day, or place it in a group. Group controls support `Superset` and `Circuit` blocks, rest settings, labels, and circuit rounds.
8. Optionally enable `Progressive Overload` and configure its mode, interval, increment, and unit.
9. Choose the AI workflow, set the available options, and select `Generate` to replace the current draft with an AI-generated workout.
10. Save the plan. A plan assigned to a client can be assigned immediately or scheduled with a start date; an existing schedule can be cancelled.
11. Open a saved plan from the list to view details or edit it. Editing an assigned plan also supports assigning it immediately, scheduling it with a start date, or cancelling its schedule.

## Options and limits

- Weekly training days are Monday through Sunday; the create flow requires a plan name and at least one selected day.
- AI equipment options are `Full gym`, `Dumbbells`, `Barbell + rack`, `Machines`, `Cables`, `Kettlebells`, `Resistance bands`, and `Bodyweight only`.
- AI split options include `Let AI decide`, `Full body`, `Upper / lower`, `Push / pull / legs`, and `Bro split`.
- AI focus options include `Hypertrophy`, `Strength`, `Fat loss`, `General fitness`, and `Conditioning — circuits`.
- AI exercise variety is a 1–5 slider.
- AI cardio options are `Warm-up only`, `Optional finishers`, and `Dedicated sessions`.
- AI units are `kg` and `lb`.
- Progressive Overload modes are `Auto (when last session completed)` and `Interval (every N sessions)`; interval sessions are constrained to a minimum of 1, and circuit rounds are constrained from 1 through 20.
- The AI session length is optional and is included only when entered as a positive number.

## AI access

- Spotter: `builder_read_draft` (read), `builder_find_exercises` (read), `builder_edit_exercises` (write to the open draft), `builder_edit_sets` (write to the open draft), `builder_edit_groups` (write to the open draft), and `builder_save` (write; save, assign, generate, or create a custom exercise). Workout tools also include `get_client_workout_plan` (read), `get_client_exercise_history` (read), `list_workout_plans` (read), `add_client_exercise` (write), `replace_client_exercise` (write), and `assign_workout` (write).
- MCP server (read-only): `get_client_workout_plan`, `get_client_exercise_history`, and `list_workout_plans.

## Related features

- [Client Management](https://nexcoach.fit/feature/clients.md)
- [Steps Goal](https://nexcoach.fit/feature/steps-goal.md)

## Not supported

- AI generation is unavailable in edit mode.
- Exercise-library filtering by source or body part is unavailable.
