Pp Ikon

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

Ikon Pass — Printing Press CLI

Prerequisites: Install the CLI

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

2. Verify: ikon-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/travel/ikon/cmd/ikon-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 this CLI for anything tied to an Ikon Pass account: checking whether a reservation-required resort (Deer Valley, Jackson Hole, Loon, Snoqualmie) has open days, reviewing your passes and Friends & Family voucher balance, and analyzing your ski history across seasons. It is read-only and offline-first — it mirrors the account API into local SQLite so history, calendars, and change-tracking work without re-fetching.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI to BOOK, modify, or cancel reservations — it is read-only by design.
• Do not use it to share or send Friends & Family vouchers — it reports remaining/used counts only.
• Do not use it for resorts that don't require reservations — most Ikon destinations are walk-on and won't appear in availability.
• Do not use it to buy or renew a pass — purchasing happens on ikonpass.com.

Unique Capabilities

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

History that compounds

• most-visited — Rank the resorts you ski most across every season you've held an Ikon Pass, with per-season day counts.

  Reach for this when the user asks where they ski most, how many days they've used over the years, or for a season-by-season breakdown.

  ikon-pp-cli most-visited --agent

• changes — After each sync, report which dates opened or closed at your watched resorts since the last snapshot.

  Use this to see what reservation availability shifted day-over-day without re-reading every resort manually.

  ikon-pp-cli changes

Reservation intelligence

• plan — Across every reservation-required resort, show which have your target dates open — one call instead of checking four resorts by hand.

  Use this when the user wants to ski a date range and doesn't care which of the reservable mountains it is.

  ikon-pp-cli plan --from 2026-01-10 --to 2026-01-20

• calendar — Month grid of open vs full vs blackout vs closed days for a reservable resort.

  Use this to eyeball a whole month of reservation openings for one resort at a glance.

  ikon-pp-cli calendar 14 --month 2026-01

• watch — Poll a resort+date and alert the moment a currently-full day frees up.

  Use this when a desired reservation date is full and the user wants to grab it if someone cancels.

  ikon-pp-cli watch 14 2026-01-17

Command Reference

account — Your account profile

• ikon-pp-cli account — Your Ikon account profile

availability — Reservation availability for reservation-required resorts

• ikon-pp-cli availability <resort_id> — Per-pass reservation availability (open/blackout/closed days, remaining slots) for a resort.

benefits — Per-pass benefits

• ikon-pp-cli benefits <product_id> — Benefits attached to a specific pass

passes — Your Ikon passes / products

• ikon-pp-cli passes — List the passes and products on your account

reservations — Your current reservations

• ikon-pp-cli reservations — List your current/upcoming reservations

resorts — Browse Ikon destinations (public — no login required)

• ikon-pp-cli resorts — List all Ikon destinations with reservation flags, codes, and regions

usage — Pass usage / redemption history

• ikon-pp-cli usage <product_id> — Season redemption history for a pass (resort, days used, redemption dates). Each pass = one season.

vouchers — Friends & Family shared vouchers

• ikon-pp-cli vouchers <product_id> — Friends & Family shared-voucher summary (remaining / used) for a pass

Finding the right command

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

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

Lifetime resort ranking for an agent

ikon-pp-cli most-visited --agent

Returns season-joined day counts per resort as JSON an agent can summarize directly.

Trip planning across reservable resorts

ikon-pp-cli plan --from 2026-01-10 --to 2026-01-20

Shows which of the reservation-required resorts have open days in the window.

Narrow resort data with field selection

ikon-pp-cli resorts --agent --select name,id,reservations_enabled

The resorts payload is large; --select trims it to just the fields an agent needs to resolve a name to an id.

Watch a full date for openings

ikon-pp-cli watch 14 2026-01-17

Polls Jackson Hole for 2026-01-17 and alerts when the date frees up.