How it works Commands Examples About

Bot Commands

All commands available in the OpenPacemaker Telegram bot.

Getting started
/start

Show your status overview, sync state, and a link to connect your Strava account if not yet linked.

/sync

Fetch your latest activities from Strava and update the local cache. Run this if the bot seems out of date.

/onboarding

Guided athlete assessment — analyses your full Strava history, asks about injuries and preferences, builds your athlete profile, and generates a personalised training plan. Run this once after connecting Strava.

/sport [run|ride|hike|swim|walk|all]

Set the activity type filter. All analysis and summaries will focus on this sport.

/sport run
Daily coaching
/today

Show today's prescribed training session from your plan — type, target pace, distance, and notes.

/week [N]

This week's actual km vs planned km, with a day-by-day breakdown. Pass a week number to see a specific week.

/week 3
/countdown

Days remaining to your goal race, current training phase, and a one-line readiness note.

/last

Full detail on your most recent activity: distance, pace, HR zones, GAP, and how it compared to the plan.

Analysis
/analyse

Claude analyses your last activity against the training plan — effort flags, HR zone distribution, coaching verdict, and debrief prompt.

/reanalyse

Force a fresh analysis of the last activity on demand, bypassing the cache.

/breakdown [weeks]

Time-in-zone breakdown across the last N weeks, calculated from second-by-second heart rate streams fetched directly from Strava — not lap averages. Shows true minutes in each HR zone so you can see whether your easy runs are actually easy.

/breakdown 6
/load

Training load dashboard: CTL (fitness), ATL (fatigue), TSB (form) from your actual Strava data, with a 12-week table showing distance and elevation per week as a bar chart.

/readiness

Race readiness assessment based on CTL, TSB, plan adherence, and recent training quality.

Training plan
/setplan <goal description>

Generate a new personalised training plan with Claude. Describe your goal race, current fitness, and constraints in plain English.

/setplan half marathon in 1:21 on May 17th, current shape 1:28, max 5 days, max 70km/week
/planview

Week-by-week plan overview showing each week's sessions and total planned km.

/editweek <N> <instruction>

Ask Claude to adapt a specific week — swap sessions, reduce load, or add a race.

/editweek 4 I have a work trip Wednesday–Friday, adjust accordingly
/adherence [weeks]

Plan adherence score for the last N weeks: sessions completed, partial, missed, and rest days honoured.

/adherence 8
Zones & results
/zones

Show your current HR and pace training zones.

/setzones <resting_hr> <max_hr>

Recalculate HR zones using the Karvonen formula from your resting and max heart rate.

/setzones 48 188
/results

Race results log with VDOT equivalents and equivalent predictions across distances.

/setpbs <distance and time>

Save personal bests in plain English. Stored as race results and records — feeds VDOT calculations and pace zone recommendations.

/setpbs 5K in 17:30, 10K in 37:40, half marathon in 1:21
Health & wellness
/wellness

Show your active injury and wellness log.

/wellness <body_part> <1–10> [notes]

Log a new issue. Severity 1 = minor niggle, 10 = can't run.

/wellness left knee 4 tight after long run
/wellness resolve <id>

Mark an issue as resolved.

Garmin integration
/garmin connect

Link your Garmin Connect account. The bot asks for your email and password, authenticates via Garmin's SSO (including 2FA if enabled), and stores a session token — you only need to do this once per year.

/garmin [week]

Upload the current week's training sessions directly to your Garmin Connect library as structured workouts — with pace targets from your VDOT and interval steps expanded into repeat groups. Open Garmin Connect and sync your watch to see them. Pass a week number to upload a specific week.

/garmin 6
Settings & account
/model [haiku|sonnet|opus]

Switch the Claude model used for chat responses. Haiku is fastest, Opus is most capable.

/memory

Show coaching memory stats — how many notes the bot has stored about your training.

/clear

Clear the current conversation history. Useful if the context gets cluttered.

/delete confirm

Permanently and immediately delete all your data from OpenPacemaker. This cannot be undone.

/feedback <message>

Send feedback directly to the developer. Anything — bugs, ideas, things you love or hate.

/feedback the RPE buttons are great but I'd love a weekly summary on Monday mornings
/help

Show the command list inside Telegram.

← Back to openpacemaker.com