Pp Axs

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

SRAM AXS — Printing Press CLI

Prerequisites: Install the CLI

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

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

SRAM AXS CLI for bikes, components, registrations, ride activities, and synced component-summary analytics.

When to Use This CLI

Reach for this CLI when a rider or agent needs scriptable access to a SRAM AXS account: listing bikes and components, registering parts by serial, checking synced firmware/battery status, browsing the model catalog, reviewing ride activities, or querying synced data offline.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI to flash or install firmware; it can report web-visible firmware status only.
• Do not use it to configure shifting behavior or pair components over BLE — that is a phone-app/Bluetooth task, not an HTTP API task.
• Do not use it for non-SRAM drivetrains.

Unique Capabilities

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

Synced component-summary views

• firmware-check — Show the latest synced firmware version per AXS device type.

  Pick this when an agent needs the current synced firmware signal without clicking through every component.

  axs-pp-cli firmware-check --json

• battery — Latest synced battery status per AXS device type, including voltage when available.

  Pick this for a quick pre-ride battery signal across synced AXS device types.

  axs-pp-cli battery --json

Local state that compounds

• wear — Rank components by synced shift counts, distance, and actuations from component summaries.

  Use to find the most-used drivetrain component for maintenance planning.

  axs-pp-cli wear --json --select device_type,device_label,shift_count,fd_shift_count,rd_shift_count

• shifts — Show per-ride front/rear shift counts, chainrings, and cogs from synced component summaries.

  Use for ride-by-ride drivetrain usage analysis without dumping thousands of raw gear samples.

  axs-pp-cli shifts --totals --json

• since — Show new ride activities and notifications since your last sync.

  Pick this to catch up on what changed without re-reading everything.

  axs-pp-cli since 7d

AXS web data joined for agents

• garage — A tree of every bike with its components and serials in one shot.

  Use as the one-command overview of a rider's whole AXS setup.

  axs-pp-cli garage

Command Reference

account — Your SRAM account profile and settings

• axs-pp-cli account accessgroups — Get your public access groups
• axs-pp-cli account export — Request a data export of your account
• axs-pp-cli account flags — Get your account feature flags
• axs-pp-cli account profile — Get your account profile

activities — Your ride activities (telemetry host)

• axs-pp-cli activities list — List your ride activities
• axs-pp-cli activities types — List activity types

bikes — Your registered bikes

• axs-pp-cli bikes get — Get a bike by ID
• axs-pp-cli bikes list — List your registered bikes

components — Your AXS components (derailleurs, shifters, batteries, dropper posts)

• axs-pp-cli components get — Get a component by ID
• axs-pp-cli components list — List your AXS components

devicetypes — Catalog of AXS device types (public, no login required)

• axs-pp-cli devicetypes — List all AXS device types

linkedids — Linked third-party accounts (Strava, etc.)

• axs-pp-cli linkedids list — List your linked third-party accounts
• axs-pp-cli linkedids unlink — Unlink a third-party account

models — Catalog of component models and their firmware versions

• axs-pp-cli models — List component models and latest firmware versions

notifications — Your notifications inbox

• axs-pp-cli notifications — List your notifications

products — Product detail lookups

• axs-pp-cli products <id> — Get product detail by product ID

registrations — Register AXS components by serial number

• axs-pp-cli registrations — Register a component to your account by serial number

stats — Aggregate account stats (telemetry host)

• axs-pp-cli stats — Get your aggregate riding stats

summaries — Activity and component usage summaries (telemetry host)

• axs-pp-cli summaries activities — List per-activity summaries
• axs-pp-cli summaries components — List component usage summaries (wear, shift counts, distance)

units — Measurement / advanced units catalog

• axs-pp-cli units — List advanced measurement units

Finding the right command

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

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

Pre-ride charge check

axs-pp-cli battery --json

Lists latest battery_status per synced AXS device type.

Find stale firmware

axs-pp-cli firmware-check --json

Lists latest fw_version per synced AXS device type.

Rank drivetrain use

axs-pp-cli wear --json

Ranks component-summary records by shift-count wear proxy.

Total ride shifts

axs-pp-cli shifts --totals --json

Totals front and rear shifts across synced ride summaries.

Register a part safely

axs-pp-cli registrations create --serial ABC123 --dry-run

Shows the registration request without sending it.