Pp Airhint

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

Airhint — Printing Press CLI

Prerequisites: Install the CLI

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

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

AirHint flight price prediction API — buy/wait recommendations for airline tickets

Unique Capabilities

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

Compound query

• workflow predict-sweep — Sweep buy/wait predictions across a date range for a route, fetching live prices for each date

  Enables batch price intelligence for flexible travelers — find the cheapest AND safest date to buy

  airhint-pp-cli workflow predict-sweep STN DUB --days 14 --airline FR --json

• workflow compare-routes — Compare buy/wait predictions across multiple origin-destination pairs on the same date

  One command to compare 3+ routes vs 3+ browser tabs — agent-native travel planning

  airhint-pp-cli workflow compare-routes 2026-08-16 STN:DUB LGW:BCN MAD:LIS --json

Local state that compounds

• workflow cheapest-window — Find the cheapest departure date in a given month using the cheapest-deal-month and cheapest-airline-deal-month endpoints

  Answers 'what date in August is cheapest for STN→DUB?' without opening the browser

  airhint-pp-cli workflow cheapest-window STN DUB 8 --airline FR

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.

Discovery Signals

This CLI was generated with browser-observed traffic context.

• Capture coverage: 8 API entries from 16 total network entries
• Protocols: rest_json (75% confidence)
• Generation hints: browser_http_transport, requires_protected_client, weak_schema_confidence
• Candidate command ideas: create_airport_names — Derived from observed POST /airport-names traffic.; get_DUB — Derived from observed GET /cheapest-deal-month/one-way/STN/DUB/{dub_id} traffic.; get_search — Derived from observed GET /search/{search_id} traffic.; list_2026_08_16 — Derived from observed GET /predict/FR/STN/DUB/2026-08-16 traffic.; list_airport_autocomplete — Derived from observed GET /airport-autocomplete traffic.; list_inline_ads — Derived from observed GET /inline-ads traffic.; list_kayak_location_lookup — Derived from observed GET /kayak-location-lookup traffic.
• Caveats: weak_schema_evidence: Binary or protobuf response cannot provide reliable JSON schema evidence.

Command Reference

airport-autocomplete — Airport and city search autocomplete

• airhint-pp-cli airport-autocomplete — Search airports and cities by name or IATA code

airport-names — Bulk airport name lookup

• airhint-pp-cli airport-names — Get airport names for a list of IATA codes

cheapest-airline-deal-month — Find the cheapest deal for a specific airline in a month

• airhint-pp-cli cheapest-airline-deal-month <airline> <origin> <destination> <date> <currency> — Get cheapest fare for a specific airline on a route near a date

cheapest-deal-month — Find the cheapest flight deal in a given month

• airhint-pp-cli cheapest-deal-month <origin> <destination> <month> — Get the cheapest one-way fare for a route in a given month

flights — Flight search — find available flights and current prices

• airhint-pp-cli flights create-search — Initiate a flight search, returns a search_id for polling
• airhint-pp-cli flights get-search — Poll for search results using the search_id from create_search

predict — Flight price prediction — buy or wait recommendations

• airhint-pp-cli predict <airline> <origin> <destination> <date> — Get buy/wait recommendation for a flight at a given price

Finding the right command

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

airhint-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.

Auth Setup

No authentication required.

Run airhint-pp-cli doctor to verify setup.