Pp Gravitus

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

Gravitus — Printing Press CLI

Prerequisites: Install the CLI

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

2. Verify: gravitus-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/other/gravitus/cmd/gravitus-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

Use gravitus-pp-cli as the data pipeline for any training dashboard or analysis tool that needs Gravitus workout data. It is the only reliable way to authenticate with Gravitus, paginate full workout history, and write structured LiftingSession records into SQLite.

When Not to Use This CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

Unique Capabilities

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

Dashboard pipeline

• sync — Sync all Gravitus workouts into your training dashboard's SQLite database — writes LiftingSession records in the exact Prisma schema format with auth, pagination, and incremental support.

  Use to populate the training dashboard's lifting data — the only reliable way to authenticate and paginate all workout history into dev.db.

  gravitus-pp-cli gravitus-sync --dashboard-db ./prisma/dev.db

• export — Export your complete Gravitus training history to CSV or JSON — the first and only way to get your data out of Gravitus.

  Use when a coach, analyst, or AI agent needs the full training history outside the app.

  gravitus-pp-cli export --format csv --output training_history.csv

Analytics

• exercises plateau — Identifies exercises where estimated 1RM hasn't improved in N weeks — alert-style output for the dashboard coaching panel.

  Use before a program change — gives evidence-based list of which lifts need intervention.

  gravitus-pp-cli exercises plateau --weeks 6 --agent

• stats volume — Weekly total lifting volume (lbs) aggregated from all synced sessions — the same metric the dashboard LiftingSection displays.

  Use to feed the dashboard's volume trend chart or check load progression over a training block.

  gravitus-pp-cli stats volume --weeks 12 --agent

• exercises prs — All-time PRs across every exercise, extracted from PR markers on workout pages.

  Use to display the personal records panel in the dashboard or track PR cadence.

  gravitus-pp-cli exercises prs --agent

HTTP Transport

This CLI uses Chrome-compatible HTTP transport for browser-facing endpoints. It does not require a resident browser process for normal API calls.

Command Reference

accounts — Authentication — login and session management

• gravitus-pp-cli accounts — Fetch login page to retrieve CSRF token

exercises — Exercise history, personal records, and volume trends

• gravitus-pp-cli exercises <exercise_slug> — Fetch exercise history with PR timeline and volume data

users — User profile and paginated workout history

• gravitus-pp-cli users <user_id> — Fetch user profile and paginated workout history list

workouts — Workout sessions with exercises, sets, reps, weight, and PRs

• gravitus-pp-cli workouts <workout_id> — Fetch full workout detail — exercises, sets, reps, weight, personal records

Finding the right command

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

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

Full initial sync into dashboard

gravitus-pp-cli gravitus-sync --dashboard-db ./prisma/dev.db

Pulls all workout pages with pagination and writes every session to dev.db

Incremental sync (run daily)

gravitus-pp-cli gravitus-sync --incremental --dashboard-db ./prisma/dev.db

Only fetches workouts not already in dev.db — fast and safe to run repeatedly

Find plateaued lifts for coaching panel

gravitus-pp-cli exercises plateau --weeks 6 --agent --select exercise,last_pr_date,weeks_stalled

Returns structured JSON of stalled lifts for the dashboard coaching panel

Export full history to CSV

gravitus-pp-cli export --format csv --output training_history.csv

Dumps every workout and set to CSV — useful for offline analysis or backup

Weekly volume for charting

gravitus-pp-cli stats volume --weeks 12 --agent

Returns 12 weeks of volume totals as JSON — feed directly to a Recharts bar chart

Auth Setup

Gravitus uses Django session auth. Run gravitus-pp-cli auth login-password with your email and password — the CLI handles the CSRF token exchange and stores your session cookie in the config file. Re-run auth login whenever the session expires (typically every few weeks).

Run gravitus-pp-cli doctor to verify setup.