Pp Intervals Icu

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/other/intervals-icu/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Intervals.icu — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the intervals-icu-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer:

   npx -y @mvanhorn/printing-press-library install intervals-icu --cli-only

2. Verify: intervals-icu-pp-cli --version
3. Ensure $GOPATH/bin (or $HOME/go/bin) is on $PATH.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

go install github.com/mvanhorn/printing-press-library/library/other/intervals-icu/cmd/intervals-icu-pp-cli@latest

If --version reports "command not found" after install, the install step did not put the binary on $PATH. Do not proceed with skill commands until verification succeeds.

Sync your activities, wellness, calendar, workouts and gear into local SQLite, then search, run SQL, and compute fitness/form trends offline. Wraps the full intervals.icu REST API for live reads and writes, and adds analytics every existing MCP server and wrapper leaves on the table.

When to Use This CLI

Use when an agent or user needs to query intervals.icu training data programmatically: pulling activities, wellness, calendar and workouts, computing fitness/form, or comparing performance curves across seasons. Best when repeated queries make a local synced store worthwhile.

Anti-triggers

Do not use this CLI for:

• Do not use for real-time device streaming during a ride
• Do not use to edit another athlete's data without coach permissions
• Do not use as a replacement for the web UI's interactive charts

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Local state that compounds

• sync — Sync your full activity, wellness, event, workout and gear history into a local SQLite database for offline search and SQL.

  Reach for this first so search/sql/form work offline without hammering the API on every query.

  intervals-icu-pp-cli sync --since 365d

• form — Compute CTL (fitness), ATL (fatigue) and TSB/form from your synced activity load and show the trend.

  Use to answer 'am I fresh enough to race / overreaching?' without opening the web UI.

  intervals-icu-pp-cli form --days 90 --json

• since — Show planned workouts, completed activities, and what was missed within a recent time window.

  Use for a quick 'what happened / what's coming' digest after time away.

  intervals-icu-pp-cli since 7d --json

Offline analysis

• curve compare — Compare best power/pace/HR curves between two date ranges from the local store.

  Use to quantify season-over-season fitness change for a given duration.

  intervals-icu-pp-cli curve compare --metric power --this 90d --vs 365d --json

• wellness trends — Correlate HRV / resting HR / sleep against training load over a window from the local store.

  Use to spot whether HRV/resting-HR are tracking accumulated fatigue.

  intervals-icu-pp-cli wellness trends --days 60 --json

• gear status — Roll up distance/time per gear component against reminders to flag what needs service or replacement.

  Use to catch chain/tyre/shoe replacement thresholds before they are overdue.

  intervals-icu-pp-cli gear status --json

Command Reference

activity — Manage activity

• intervals-icu-pp-cli activity delete — Delete an activity
• intervals-icu-pp-cli activity get — An empty stub object is returned for Strava activities
• intervals-icu-pp-cli activity update — Strava activities cannot be updated

athlete — Manage athlete

• intervals-icu-pp-cli athlete get — Get the athlete with sportSettings and custom_items
• intervals-icu-pp-cli athlete update — Update an athlete

athlete-plans — Manage athlete plans

• intervals-icu-pp-cli athlete-plans — Change training plans for a list of athletes

chats — Manage chats

• intervals-icu-pp-cli chats send-message — Returns the new message id. If a new chat was created then it is also returned.
• intervals-icu-pp-cli chats show — Get a chat by id

disconnect-app — Manage disconnect app

• intervals-icu-pp-cli disconnect-app — Disconnect the athlete from the app matching the bearer token

download-workout-ext — Manage download workout ext

• intervals-icu-pp-cli download-workout-ext <ext> — The athlete to use is extracted from the bearer token and used to resolve power targets etc..

pace-distances — Manage pace distances

• intervals-icu-pp-cli pace-distances — List pace curve distances

shared-event — Manage shared event

• intervals-icu-pp-cli shared-event <id> — Get a shared event (e.g. race)

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

intervals-icu-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Season-over-season power

intervals-icu-pp-cli curve compare --metric power --this 90d --vs 365d --json --select this.peaks,vs.peaks

Compare recent best power against a year ago, selecting just the peak arrays.

Fresh enough to race?

intervals-icu-pp-cli form --days 42 --json

Show six weeks of fitness/fatigue/form to judge taper readiness.

Catch up after a break

intervals-icu-pp-cli since 14d

Digest of planned, completed and missed sessions over two weeks.

Auth Setup

Run intervals-icu-pp-cli auth setup to print the URL and steps for getting a key (add --launch to open the URL). Then set:

export INTERVALS_ICU_API_KEY="<your-key>"

Or persist it in ~/.config/intervals-icu-pp-cli/config.toml.

Run intervals-icu-pp-cli doctor to verify setup.