# Habit Tracking — NexCoach

> Habit Tracking lets trainers assign, schedule, monitor, pause, edit, remove, and restore client habits.

- Page: <https://nexcoach.fit/feature/habit-tracking>
- App location: `/trainer/habit-tracking`
- 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

- Select a client and view that client's assigned habits.
- Create a new habit or edit an existing habit.
- Configure a habit as `Yes / No` or `Count / Target`.
- Configure a `Daily` or `Specific days` schedule and an optional reminder time.
- Choose an icon and accent color for the habit.
- Pause or reactivate a habit with its active switch.
- Remove a habit while retaining past logs. It remains on the client's list for the current day, is removed starting tomorrow, and can be restored from the `Removed habits` list.
- Habit cards show the title, optional description, type or target, schedule, reminder time, and `Paused` status.

## How it works

1. Open `/trainer/habit-tracking` and use `Select a client`.
2. With a client selected, choose `New Habit`, or use `Build the first habit` when that client has no habits.
3. In `New Habit`, select the `Client`, enter a `Title`, optionally enter a `Description`, choose an `Icon`, and choose an `Accent color`.
4. Choose `Yes / No` or `Count / Target`. Count habits require a positive `Target` and a non-empty `Unit`.
5. Choose `Daily` or `Specific days`. For `Specific days`, select one or more days under `Days`. Optionally set `Reminder time` in `HH:mm` format.
6. Select `Create habit`. The saved habit is assigned to the selected client and the page returns to that client's habit list.
7. When editing, the `Client` selector is disabled and saving uses `Save changes`. On an existing habit, use the active switch to pause or reactivate it, the edit control to open `Edit Habit`, or the remove control to open the confirmation dialog.
8. The remove dialog offers `Cancel` and `Remove`. Removed habits appear under `Removed habits`; select `Restore` to return the habit to the client's list from today.

## Options and limits

- Title is required and limited to 80 characters.
- Description is optional and limited to 280 characters.
- Type options are `Yes / No` and `Count / Target`.
- Count targets must be greater than 0; units are limited to 20 characters.
- Frequency options are `Daily` and `Specific days`.
- `Specific days` uses `Sun`, `Mon`, `Tue`, `Wed`, `Thu`, `Fri`, and `Sat`; at least one day is required.
- Reminder time is optional and must use `HH:mm` (24-hour) format.
- Available icons are `Droplets`, `Footprints`, `Moon`, `Dumbbell`, `Apple`, `Salad`, `BookOpen`, `Brain`, `Cigarette`, `Sun`, `HeartPulse`, and `Pill`.
- Available accent colors are `Emerald`, `Cyan`, `Rose`, `Amber`, `Violet`, and `Indigo`.

## AI access

- Spotter: `get_client_habits` (read). It returns a trainer-owned client's habits, completion counts, adherence percentages, and `active`, `paused`, or `removed` status for a calendar-day window. `days` defaults to 14 and is capped at 90. Adherence counts completed log entries in the window; removed habits are included only when relevant history exists and report adherence through the removal day.
- MCP server (read-only): `get_client_habits`.

## Related features

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