Garmin Double Progression

Reads what you actually lifted from Garmin Connect and advances the targets in your Garmin workouts automatically, using double progression.

Train, run one command, sync your watch. Next session's numbers are already waiting on it.

$ repwise update

Activity: Workout B (1234567890)
Updating: Workout B -> workout 111111111

  # EXERCISE               ACTION  SETS     BEFORE      AFTER     CONFIG WHY
* 1 Barbell Deadlift       advance 3    10 x 60 kg  ->  6 x 65 kg        hit 10 on every set, top of the range
* 2 Dumbbell Lateral Raise advance 3     12 x 8 kg  ->  13 x 8 kg note   add 1 rep
  3 Sit-up                 hold    3       11 reps  ==  11 reps          missed target, 10 on the worst set

Dry run: 2 step(s) would change. Re-run with --apply.

Quick start

You need workouts already built in Garmin Connect, and Python 3.14 or newer.

pipx install repwise

repwise import -o workouts.yaml   # build a config from your Garmin workouts
repwise update                    # after a session: see what would change
repwise update --apply --push     # write it, and send it to your watch

The first command that reaches Garmin asks for your email, password and MFA code, then caches the tokens Garmin issues so later runs do not. Your password is never written anywhere. The token is - in settings.garmin.token_store (defaulting to ~/.config/repwise), readable only by you - and until it expires it is as good as being logged in. repwise logout deletes it. See authentication.

Nothing is written to Garmin without --apply. A dry run is the default.

For Tab completion, add source <(repwise completion bash) to ~/.bashrc, or source <(repwise completion zsh) to ~/.zshrc after compinit.

The full walkthrough is in Getting started.

What it does

It compares what you performed against the target stored in Garmin and picks the next one. Every workout in your config is advanced from its own latest session, so training A and then B and running once brings both up to date:

1. Start at the bottom of the rep range.
2. Add a rep to every set each session.
3. Once every set reaches the top of the range twice, add weight and reset to the bottom.
4. If you missed the target, repeat it unchanged.
5. A load only counts once you can carry it for the bottom of the range.

Three things it handles that a spreadsheet would not:

• It judges progress by your weakest set. Extra reps on the easy sets do not pull the target somewhere you cannot repeat.
• It eases you back after a stall. Miss a target twice and the session that finally beats it earns a rep on two of your four sets rather than on all of them, so you are not asked again for the jump that just failed. Set partial_progression: false if you would rather every set moved together.
• It follows the weight you actually used. Bump the load mid-session and the new load is banked, not discarded.
• It won't keep a load you didn't earn. Take the 4 kg dumbbells because the 3 kg pair was gone, come up short of the range, and your target stays where it was rather than following you onto a weight that was too heavy.

Each exercise also gets a one-line note on its Garmin step, such as 6-10 reps | +5 kg, so the watch shows what you are working towards and not just today's target. Notes you wrote yourself are left alone.

Your config is the workout

workouts.yaml decides what a workout is; Garmin keeps track of where each exercise has got to. Edit the file and the next run brings Garmin into line:

• Write a workout that does not exist yet. Leave garmin_workout_id out and it is built in Garmin, then the id is written back into your file.
• Reorder the exercises. The order in the file is the order on the watch. Add one and it is added; delete one and it is deleted.
• Set the rests and the sets. Including the rest between exercises, which Garmin leaves as a wait for the lap button until you ask for a time.

An exercise that moves keeps everything it had, target included, because the step itself is moved rather than rebuilt. That is the difference between reordering your workout and quietly restarting your progression.

Nothing reaches Garmin without --apply, and a dry run prints every addition, removal and move first.

It also covers timed holds like planks, exercises the watch counts per side, and keeping an exercise in sync when it appears in more than one workout. Progression explains every decision it can make.

Commands

Any command takes -v to show debug output as well. Full flags and output for each are in Commands.

Your routine

Your routine lives in workouts.yaml: the exercises, their order, rep ranges, set counts, rests, and which Garmin workout each belongs to. Generate it with repwise import, or copy workouts.example.yaml - a complete working A/B full body split, annotated field by field.

It is the source of truth rather than a copy of one: update writes what it says to Garmin, and the only thing ever written back into it is an id Garmin issues for a workout it has just created.

That file is gitignored, so your routine and Garmin ids stay out of version control. Every field is described in Configuration.

Documentation

For users:

For contributors:

Licence

MIT.