Pp Ridewithgps

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

Ride with GPS — Printing Press CLI

Prerequisites: Install the CLI

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

2. Verify: ridewithgps-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.4 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/travel/ridewithgps/cmd/ridewithgps-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.

A fast, scriptable, agent-native CLI for Ride with GPS with a local SQLite mirror of your routes and trips. Bulk-export everything (with cue sheets) to GPX/TCX/CSV for your bike computer with 'export', pull an organized ride's routes with 'event-routes', track per-bike mileage with 'gear', see this month's climbing with 'stats', surface all-time bests with 'records', and clean a junk-drawer library with 'dedup' and 'audit' — none of which the web app or any existing tool does.

When to Use This CLI

Use this CLI to bulk-export Ride with GPS routes and trips to files, mirror a library offline and query it without the API, roll up training volume and personal records from logged rides, track per-bike gear mileage and maintenance, and script route/event/POI operations. It is the right tool when a task is about your existing library and ride history rather than building or navigating a new route.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI for live turn-by-turn navigation — use the Ride with GPS mobile app.
• Do not use this CLI to draw or build a new route on a map — use the web route planner.
• Do not use this CLI to record a ride from GPS in real time — use the mobile app.
• Do not use this CLI for the social activity feed or following other riders.

Unique Capabilities

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

Routes onto your bike computer

• export — Export many routes or trips to GPX, TCX, CSV, or KML files in one command — with cue sheets included, ready to side-load onto a Garmin, Wahoo, or Hammerhead. The bulk export Ride with GPS itself won't do.

  Reach for this when a user wants routes onto a bike computer or rides as files on disk — one command instead of clicking export per route in the web app.

  ridewithgps-pp-cli export --type routes --format gpx --out ./gpx

• event-routes — List the routes attached to an event (group ride, gran fondo, brevet) and optionally export them straight to files for your bike computer.

  Reach for this when a user has signed up for an organized ride and wants that event's official routes on their head unit.

  ridewithgps-pp-cli event-routes 12345678 --export gpx --out ./fondo

Ride analytics that compound

• gear — Per-bike accumulated mileage from your logged rides, plus maintenance-due flags against wear thresholds.

  Reach for this to answer 'how many miles since my last chain swap' or 'which bike needs service' without a spreadsheet.

  The default scans the 100 most recent synced trips and labels totals as partial when older trips remain. Use --max-scan-trips=0 for a complete scan; it reads detail for every synced trip, using cached responses where available. Add --no-cache when fresh detail is required.

  ridewithgps-pp-cli gear --due-km 4000 --agent

• stats — Time-windowed distance, elevation, and moving-time totals with activity-type breakdowns over your logged rides.

  Reach for this for 'how far did I ride this month' or 'how much have I climbed this year' — period totals, not single efforts.

  ridewithgps-pp-cli stats --period month --agent

• records — All-time best efforts — longest ride, most climbing, fastest average speed, biggest power — from your trip metrics.

  Reach for this for 'what's my longest ride' or 'my biggest climbing day' — top-N extremes, not period sums.

  ridewithgps-pp-cli records --metric elevation --top 10 --agent

Library hygiene

• dedup — Find near-duplicate routes by distance and start/end geometry, and optionally delete the extras.

  Reach for this to clean a route library full of near-identical versions of the same loop.

  ridewithgps-pp-cli dedup --threshold 100 --agent

• audit — Flag routes that are stale, private, or incomplete (missing name, description, or distance) — catalog hygiene across your library.

  Reach for this before an event season to find routes that are stale, private when they should be shared, or missing details.

  ridewithgps-pp-cli audit --checks stale,private --agent

Command Reference

auth_tokens — Manage auth tokens

• ridewithgps-pp-cli auth-tokens — Creates a new authentication token for API access using user credentials.

collections — Manage collections

• ridewithgps-pp-cli collections get — Returns detailed information about a specific collection
• ridewithgps-pp-cli collections get-pinned — Returns the authenticated user's pinned collection
• ridewithgps-pp-cli collections list — Returns a paginated list of collections for the authenticated user. Supports filtering by name and visibility.

events — Manage events

• ridewithgps-pp-cli events create — Creates a new event for the authenticated user.
• ridewithgps-pp-cli events delete — Deletes an event owned by the authenticated user
• ridewithgps-pp-cli events get — Returns detailed information about a specific event
• ridewithgps-pp-cli events list — Returns a paginated list of events accessible to the authenticated user. Supports filtering by name and visibility.
• ridewithgps-pp-cli events update — Updates an existing event owned by the authenticated user.

members — Manage members

• ridewithgps-pp-cli members get-club — Returns detailed information about a specific club member
• ridewithgps-pp-cli members list-club — Returns a paginated list of members for the authenticated organization account.
• ridewithgps-pp-cli members update-club — Updates a club member's permissions and status.

points_of_interest — Manage points of interest

• ridewithgps-pp-cli points-of-interest associate-point-of-interest-with-route — Associates a point of interest with a specific route Note: This endpoint is available for organizations only.
• ridewithgps-pp-cli points-of-interest create-point-of-interest — Create a new point of interest in the authenticated organization's library.
• ridewithgps-pp-cli points-of-interest delete-point-of-interest — Deletes a point of interest owned by the authenticated organization.
• ridewithgps-pp-cli points-of-interest disassociate-point-of-interest-from-route — Removes the association between a point of interest and a specific route Note
• ridewithgps-pp-cli points-of-interest get-point-of-interest — Returns detailed information about a specific point of interest.
• ridewithgps-pp-cli points-of-interest list — Returns a paginated list of points of interest for the authenticated organization.
• ridewithgps-pp-cli points-of-interest update-point-of-interest — Updates an existing point of interest in the authenticated organization's library.

routes — Manage routes

• ridewithgps-pp-cli routes delete — Deletes a route owned by the authenticated user
• ridewithgps-pp-cli routes get — Returns detailed information about a specific route
• ridewithgps-pp-cli routes get-polyline — Returns an encoded polyline string for the specified route.
• ridewithgps-pp-cli routes list — Returns a paginated list of routes for the authenticated user.

sync-json — Manage sync json

• ridewithgps-pp-cli sync-json — Returns a list of items (routes and/or trips) that the user has interacted with since the given datetime.

trips — Manage trips

• ridewithgps-pp-cli trips delete — Deletes a trip owned by the authenticated user
• ridewithgps-pp-cli trips get — Returns detailed information about a specific trip
• ridewithgps-pp-cli trips get-polyline — Returns an encoded polyline string for the specified trip.
• ridewithgps-pp-cli trips list — Returns a paginated list of trips for the authenticated user.

users — Manage users

• ridewithgps-pp-cli users — Returns information about the currently authenticated user