A spotter watches what you can't see, and never lifts the bar for you.
Spotter is a client-management workspace for a fitness professional, run entirely by talking to an AI assistant. Your Clients' Programs, Sessions, Homework, nutrition, Metrics, and the personal details that make each Client feel remembered — all of it lives in plain files here, and the Assistant keeps them for you. You talk; it files. Each morning you ask "what's on the agenda today?" and get your whole day in two minutes.
Every coaching decision stays yours. Spotter drafts, tracks, and remembers; it never changes a Program or a nutrition approach without your say-so.
There is no app to install and no account to create. The workspace is a folder of readable markdown that works with whatever AI agent you already pay for — Claude Code, Codex, Gemini CLI, Grok, or any of them inside VS Code.
- An AI agent that can read and edit files in a folder — if you can open a folder with it and type to it, it qualifies.
- A GitHub account (free), to make your own copy of this workspace.
That's it. Everything else is conversation.
- On this repository's GitHub page, click Use this template, then Create a new repository.
- Name it whatever you like — and set it to Private. Your real Client records never leave your machine by design, but a private copy is the right default anyway (see the privacy notice).
- Get the folder onto your computer: GitHub Desktop's Clone button is the no-terminal route;
git cloneworks if you know it; Code → Download ZIP works too if git isn't your thing.
Open the folder in your AI agent and say:
what's on the agenda today?
A fresh copy ships alive: ten fictional Demo Clients with real-looking histories and a Schedule that books them across the week. The Briefing you just asked for, the Session logging, the Progression Charts — everything demonstrates itself on the demo roster before a single real Client is in the system. Poke at it freely; the demo data is there to be played with.
The Demo Clients' histories carry fixed dates from the day they were written, so the further you are from mid-2026, the more the Briefing will nag about their unlogged Sessions. That's the demo aging, not the product misbehaving.
When you're ready, say:
set me up
The Setup Interview captures who you are — certifications, methodology, what's on your gym floor, working hours, preferences — into your Coach Profile (coach-profile.md, created on your machine, never shipped anywhere). From then on every ritual reads it: Program design programs the way you program, and the Assistant speaks to you as your Assistant, not a generic one. Setup ends with a plain-language privacy notice and a one-line acknowledgment.
When the demonstration has done its job, say:
we're going live — remove the demo data
The Assistant shows you exactly what will go, asks for one confirmation, and clears every Demo Client and demo Schedule entry in one pass. Then bring in your first real Client:
just signed a new client — Jamie R. Here are my intake notes: …
Onboarding is a short interview seeded by whatever notes you already have — it asks only for what's missing, adds the booked slots to the Schedule, and offers to design the Program on the spot.
New here? The user guide walks you through your first hour, one sentence at a time. The short version — everything is a sentence to the Assistant, and this is the rhythm most Coaches settle into:
- Morning — "what's on the agenda today?" The Briefing: per scheduled Client, who they are, today's plan, watch items, and what to ask about, every line linked to the record it came from.
- After a Session (or at day's end) — "log Sarah: squat 135 3x5, knee was fine, half her homework done, daughter graduates Saturday." One Dump, however messy, and the Assistant routes it: journal, Metrics, Homework, personal notes. Dictate it, paste it, photograph the notepad — all fine.
- End of day — "wrap up my day." The Wrap-up checks today's Schedule against what got logged and prompts only for the gaps.
- Schedule changes — "Mike cancelled Thursday." "New client Tuesdays at 7." Said in plain language, landed in the Schedule; you never edit a table yourself.
- Programs — "design a Program for Alex." An interview if you want a thinking partner, or state the Program you already have in your head and it's structured as written. Either way nothing lands in a Program without your approval — you are the professional of record, always.
- Progress — "show me her squat progress." A Progression Chart, drawn on demand from the Metrics your Dumps have been quietly accumulating.
- Deeper guidance — "run this by the strength coach." A Roster of Specialists — Strength & Conditioning, Nutrition, Recovery — advises on request, and you can Hire more or Train any of them on your own methodology. Their output is drafting support for your judgment, never a decision. Anything that smells medical — pain, injury — gets referred out to a qualified professional, no exceptions.
This workspace is plain files on your machine: no server, no telemetry, nothing transmitted on its own. Talking to the Assistant sends what it reads — including Client records — to the AI provider behind your agent, under that provider's terms; the system keeps records data-minimal (first name + last initial, no contact, billing, or medical data) so there's less to send. The full picture is one screen: docs/privacy-notice.md.
- The user guide — the full walkthrough, one sentence at a time
- What's in the demo — the ten Demo Clients and what each one exhibits
- Privacy notice — one screen
- Changelog — what's in each release
Spotter is MIT licensed. It is a tool for a qualified fitness professional, not a substitute for one, and it does not give medical advice.