Pp Walkingpad

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

WalkingPad — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the walkingpad-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 walkingpad --cli-only

2. Verify: walkingpad-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):

go install github.com/mvanhorn/printing-press-library/library/devices/walkingpad/cmd/walkingpad-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.

When to Use This CLI

Reach for this CLI whenever an agent or script needs to inspect a WalkingPad's recorded walk history, compute streaks/trends/calories, or drive a physical belt from a laptop instead of the phone app. It is ideal for "how far did I walk today / this week", consecutive-day streak tracking, calorie estimates the belt won't report, exporting walks to Apple Health, and — on a live build — starting, holding, and stopping the belt over a reliable held BLE connection. The MCP surface mirrors the read and history/analytics commands so an agent can answer walking questions without the phone app.

Unique Capabilities

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

Local history & analytics

The belt loses its run memory on power-cut. This CLI persists every recorded walk locally so the long view survives.

• today — Today's recorded totals: distance, steps, active minutes, session count.

  walkingpad-pp-cli today --json

• streak — Current consecutive-day walking streak.

  walkingpad-pp-cli streak --json

• trends — Per-day distance, steps, and active minutes over a window (including zero-activity days).

  walkingpad-pp-cli trends --days 30 --json

• calories — Estimate calories burned from your body weight (the belt never reports them). Set weight first with profile set --weight <kg>.

  walkingpad-pp-cli profile set --weight 80
  walkingpad-pp-cli calories --days 7 --json

• export — Write daily.json (last 60 days) and yesterday.json for an iPhone Shortcut to log Walking workouts into Apple Health.

  walkingpad-pp-cli export --json

Reliable live control

• run — Hold one BLE connection for the whole walk: switch to manual, start at --speed, stream live status, record the walk, and stop with the firmware's ceremony when --duration elapses or on Ctrl-C. The only reliable way to actually walk; a one-shot start does not sustain the belt.

  walkingpad-pp-cli run --speed 2.0 --duration 30m --live --confirm-physical-effect

• stop — Idle a running belt with the firmware's stop ceremony (speed-0 → settle → standby).

  walkingpad-pp-cli stop --live --confirm-physical-effect

Device discovery

• scan — Find any compatible WalkingPad by its BLE service UUID rather than its name, so renamed or family-variant belts are still discovered.

  walkingpad-pp-cli scan --live

Command Reference

Live device control

• walkingpad-pp-cli run — Start a guided walk: run the belt over a held connection and record it
• walkingpad-pp-cli stop — Stop the belt (speed-0, settle, then switch to standby)
• walkingpad-pp-cli prefs — Configure belt preferences (max-speed, start-speed, child-lock, auto-start, sensitivity, units)

Low-level single-write commands also exist — start, wake, set-speed <kmh>, and set-mode <mode> — for advanced use. They issue one BLE write and do not sustain the belt; prefer run/stop for actual walks. See walkingpad-pp-cli --help.

Live telemetry

• walkingpad-pp-cli status — Read device status (replay-backed by default; live with --live)
• walkingpad-pp-cli monitor — Stream live belt telemetry until stopped
• walkingpad-pp-cli last-record — Read the belt's last stored run (time, distance, steps)
• walkingpad-pp-cli record — Record a live walk into the local history store

Local history & analytics

• walkingpad-pp-cli today — Show today's recorded walking totals
• walkingpad-pp-cli sessions — List recorded sessions for a date (default today)
• walkingpad-pp-cli trends — Show per-day walking totals over a window
• walkingpad-pp-cli streak — Show the current consecutive-day walking streak
• walkingpad-pp-cli calories — Estimate calories burned (the belt never reports them)
• walkingpad-pp-cli export — Export daily totals as JSON (e.g. for an Apple Health Shortcut)

Profile

• walkingpad-pp-cli profile set — Set your body weight (kg) for calorie estimates
• walkingpad-pp-cli profile show — Show your saved body profile

Diagnostics & discovery

• walkingpad-pp-cli doctor — Check BLE readiness, build, and (with --live) device reachability
• walkingpad-pp-cli capabilities — Show generated BLE capability and safety metadata
• walkingpad-pp-cli scan — Discover nearby devices by their BLE service (requires --live)
• walkingpad-pp-cli session — Manage the replay-backed local BLE session runtime