# Spotter — NexCoach

> Spotter is the in-app AI assistant for trainers.

- Page: <https://nexcoach.fit/spotter>
- App location: `/trainer/spotter` and the Ask Spotter panel
- 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

- Starts new conversations and loads, selects, and deletes conversation history.
- Supports client mentions using `@` autocomplete with up to 25 suggestions.
- Displays pending write summaries with `Approve`, `Reject`, `Approve all`, and `Reject all` controls.
- Shows workout-builder proposals with editing, exercise removal, catalog details, alternatives, applying, opening in the builder, and discarding actions.
- Shows a privacy notice that can be dismissed with `Dismiss notice`.
- Stops an in-flight response; text entered while a response is sending is queued and processed afterward.

## How it works

1. Open `/trainer/spotter` or the Ask Spotter panel.
2. Start a new conversation or select an existing conversation from history.
3. Type a message in the composer. Type `@` at the start of a word to search clients, then select a result to insert the client mention.
4. Send the message.
5. Review any pending write summary and select `Approve` or `Reject`; when several actions are pending, use the per-action buttons or `Approve all` / `Reject all`.
6. When a workout-builder proposal is shown, edit supported fields, remove proposed exercises, inspect catalog details or alternatives, then apply, open in the builder, or discard the proposal.
7. Dismiss the privacy notice with `Dismiss notice`.
8. Stop an in-flight response when needed.

## Options and limits

- Client mention autocomplete matches an `@` that starts a word and shows up to 25 suggestions.
- Spotter write tools require trainer confirmation before execution.
- Workout-builder proposal editing supports the fields returned as editable, including reps, weight, set count, and to-failure when provided by the proposal.

## AI access

- Spotter: `find_client` (read), `list_clients` (read), `get_client_onboarding` (read), `get_daily_workout` (read), `get_daily_diet` (read), `get_client_progress` (read), `get_client_macro_history` (read), `get_client_weight_history` (read), `get_client_sleep_history` (read), `get_client_mood_history` (read), `get_client_step_history` (read), `get_client_hydration_history` (read), `get_client_habits` (read), `get_client_diet` (read), `list_diet_plans` (read), `get_client_workout_plan` (read), `get_client_exercise_history` (read), `list_workout_plans` (read), `get_sessions` (read), `get_bookable_slots` (read), `list_leads` (read), `get_client_messages` (read), `list_packages` (read), `get_client_payments` (read), `get_overdue_payments` (read), `list_forms` (read), `get_form_assignments` (read), `get_morning_briefing` (read), `diagnose_client` (read), `find_clients_matching` (read), `compare_clients` (read), `get_renewal_risk` (read), `get_clients_needing_attention` (read), `draft_checkin_message` (read), `builder_read_draft` (read), `builder_find_exercises` (read); `edit_client_meal`, `add_client_meal`, `remove_client_meal`, `create_diet_plan`, `add_plan_day_meals`, `copy_plan_day`, `assign_diet`, `add_client_exercise`, `replace_client_exercise`, `assign_workout`, `set_client_hydration_goal`, `create_client_habit`, `update_client_habit`, `remove_client_habit`, `restore_client_habit`, `unassign_client_plan`, `create_client`, `update_client_details`, `convert_lead_to_client`, `post_community_update`, `send_message_to_client`, `assign_form`, `schedule_session`, `cancel_session`, `reschedule_session`, `builder_edit_exercises`, `builder_edit_sets`, `builder_edit_groups`, `builder_edit_plan`, and `builder_commit` (write; confirmation required).
- MCP server (read-only): `find_client`, `list_clients`, `get_client_onboarding`, `get_daily_workout`, `get_daily_diet`, `get_client_progress`, `get_client_macro_history`, `get_client_weight_history`, `get_client_sleep_history`, `get_client_mood_history`, `get_client_step_history`, `get_client_hydration_history`, `get_client_habits`, `get_client_diet`, `list_diet_plans`, `get_client_workout_plan`, `get_client_exercise_history`, `list_workout_plans`, `get_sessions`, `get_bookable_slots`, `list_leads`, `get_client_messages`, `list_packages`, `get_morning_briefing`, `diagnose_client`, `find_clients_matching`, `compare_clients`, `get_renewal_risk`, `draft_checkin_message`, `get_client_payments`, `get_overdue_payments`, `list_forms`, `get_form_assignments`, `get_clients_needing_attention`, and `get_my_ai_usage`.

## Related features

- [Nutrition](https://nexcoach.fit/feature/nutrition.md)
- [Workout Builder](https://nexcoach.fit/feature/ai-workout-builder.md)
- [Habit Tracking](https://nexcoach.fit/feature/habit-tracking.md)
- [Client Management](https://nexcoach.fit/feature/clients.md)
- [Messages](https://nexcoach.fit/feature/messages.md)
- [Form Reviews](https://nexcoach.fit/feature/forms.md)
- [Hydration Tracker](https://nexcoach.fit/feature/hydration.md)
- [Steps Goal](https://nexcoach.fit/feature/steps-goal.md)
- [Payments](https://nexcoach.fit/feature/payments.md)
- [Sessions](https://nexcoach.fit/feature/sessions.md)
- [Leads](https://nexcoach.fit/feature/leads.md)
- [Community](https://nexcoach.fit/feature/community.md)

## Not supported

- Spotter is restricted to users whose role is `TRAINER`; client users do not receive the Spotter interface.