Pp Withings

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/devices/withings/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/". -->

Withings — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the withings-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. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

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

2. Verify: withings-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/devices/withings/cmd/withings-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

Pulls your weight/body-composition, activity, sleep, heart/ECG and workouts from the official Withings API into a local SQLite store you can search, query with SQL, and export as JSON or CSV. On top of that it adds local-join analytics — recomp, recovery, bp-report, sleep debt, digest, correlate — that no single API call can produce.

When to Use This CLI

Use this CLI when you want programmatic, offline-queryable access to your own Withings health data and analytics across metrics over time — body recomposition, training recovery, sleep debt, BP/AFib reports for a clinician, or a structured health digest to feed an LLM. It is ideal for agents answering 'how is my health trending' and for scripted exports.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI to push data to Garmin/TrainerRoad/Strava — use withings-sync for one-way fitness-platform sync.
• Do not use it for medical diagnosis; it reports your recorded measurements and is not a clinical device.
• Do not use it to access another person's Withings data — it operates only on the authorized account.

Unique Capabilities

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

Local-join analytics

• recomp — See whether you're actually recomposing — fat mass down while lean mass holds — on a de-noised rolling-average weight, not scale-weight whiplash.

  Reach for this instead of raw measures when the question is 'is my cut/bulk working', not 'what did I weigh on Tuesday'.

  withings-pp-cli recomp --since 90d --agent

• recovery — Weigh recent workout HR-zone load against your recovery markers (resting HR, HRV, sleep score) to catch overtraining before it catches you.

  Use when deciding whether to push or back off; it correlates how hard you trained with how recovered you are.

  withings-pp-cli recovery --since 14d --agent

• sleep debt — Cumulative sleep deficit against your target over a rolling window — the number the per-night summary never adds up for you.

  Use for sleep-deficit accounting over time; for one night use 'sleep summary'.

  withings-pp-cli sleep debt --window 14d --agent

• correlate — Pearson + best-lag correlation between any two daily metrics (weight vs sleep score, steps vs resting HR).

  The flexible fallback when no curated readout fits the metric pair you care about.

  withings-pp-cli correlate weight sleep_score --since 90d --agent

Clinician + agent reports

• bp-report — A dated blood-pressure + AFib table with your own annotations (medication changes, symptoms) — the clean history to hand a cardiologist.

  Use for a doctor-ready BP/AFib history; prefer it over raw 'heart list' when you need the annotated report.

  withings-pp-cli bp-report --since 90d --agent

• digest — One structured 'what changed since <time> across all my metrics' snapshot — built for piping into an agent.

  The go-to for LLM health Q&A: one cursor-driven structured pull instead of N endpoint calls.

  withings-pp-cli digest --since 24h --agent

Command Reference

activity — Daily and intraday activity: steps, distance, calories, heart-rate zones

• withings-pp-cli activity get — Daily activity aggregates (getactivity).
• withings-pp-cli activity intraday — High-resolution intraday activity series (getintradayactivity).

devices — Linked Withings devices

• withings-pp-cli devices — List linked devices (getdevice): model, battery, last sync.

goals — User goals: steps, sleep, weight

• withings-pp-cli goals — Get user goals (getgoals).

heart — ECG/AFib recordings and blood-pressure readings

• withings-pp-cli heart ecg — Get a single raw ECG signal by signalid (get).
• withings-pp-cli heart list — List heart recordings (list): ECG signalids, AFib classification, BP.

measure — Body measurements: weight, body composition, blood pressure, SpO2, temperature, ECG intervals

• withings-pp-cli measure — Get body measurements (getmeas). Filter by type codes and date range.

notify — Webhook subscriptions (Notify)

• withings-pp-cli notify get — Get one subscription (get).
• withings-pp-cli notify list — List webhook subscriptions (list).
• withings-pp-cli notify revoke — Revoke a webhook subscription (revoke).
• withings-pp-cli notify subscribe — Subscribe a webhook (subscribe).

sleep — Sleep stage series and per-night summaries

• withings-pp-cli sleep series — High-frequency sleep stage series (get).
• withings-pp-cli sleep summary — Per-night sleep summary (getsummary): durations, HR, RR, snoring, AHI, sleep score.

workouts — Workout sessions with HR zones, distance, calories

• withings-pp-cli workouts — List workout sessions (getworkouts).

Finding the right command

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

withings-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

Mirror everything, then ask offline

withings-pp-cli sync --resources measure,activity,sleep,workouts,heart --since 180d

One incremental sync populates the local store for fast offline analytics.

Agent-native health digest

withings-pp-cli digest --since 24h --agent --select weight,sleep_score,resting_hr,new_afib

Narrowed structured output an agent can consume without parsing the full envelope.