TravelMaxx CLI

Install

curl -fsSL https://travelmaxx.app/cli | sh

Or install directly from PyPI, or with Homebrew:

pipx install travelmaxx        # or: uv tool install travelmaxx
brew install travelmaxx/travelmaxx/travelmaxx

Sign in

On a server or over SSH (no browser), use the device-code flow instead — the CLI prints a 6-digit code to enter at travelmaxx.app/activate:

travelmaxx login --no-browser

Search award flights

Search a single date, or a whole month in parallel with a live progress bar. Always pass --programswhen you know which programs you can book through — it's 40–50× faster than searching all of them. Alliance shortcuts (ONEWORLD, STAR_ALLIANCE, SKYTEAM) expand to the alliance's member programs, whose awards include flights operated by partner airlines across the alliance.

# One date, one program
travelmaxx search SFO NRT --date 2026-10-05 --programs ALASKA

# Business class, two programs, two passengers
travelmaxx search SFO CDG --date 2026-09-12 --class BUSINESS \
  --programs ALASKA,UNITED --pax 2

# Any oneworld partner award (expands to the member programs)
travelmaxx search SFO NRT --date 2026-10-05 --programs ONEWORLD

# A whole month, with live progress
travelmaxx search SFO NRT --date-range november --programs ALASKA

# Machine-readable output
travelmaxx search SFO NRT --date 2026-10-05 --json

Date ranges accept november, 2026-11, 2027, next year, or 2026-11-01:2026-11-15.

Alerts & deal discovery

# Email me when business class to Tokyo drops below 75k points
travelmaxx alerts create SFO NRT --class BUSINESS --max-points 75000

travelmaxx alerts list
travelmaxx alerts delete <uuid>

# Browse featured award deals
travelmaxx discover

Portfolio & reference

View your profile, look up cards and loyalty programs, read travel guides, manage your saved flights, and check transfer partners.

# View your profile (cards, programs, flights, airline status)
travelmaxx profile

# Look up a credit card by name (SUBs, fees, multipliers)
travelmaxx cards sapphire preferred
travelmaxx cards gold --issuer amex

# Look up a loyalty program
travelmaxx programs skymiles
travelmaxx programs mileageplan --json

# Search and read ScamMax travel guides
travelmaxx guides search "chase sapphire"
travelmaxx guides read chase-sapphire-preferred-review

# Save a flight to your itinerary (optionally track its waitlist)
travelmaxx flights save AS1042 --date 2026-12-01 --origin SEA --destination SFO --track
travelmaxx flights list
travelmaxx flights remove AS1042 --date 2026-12-01

# See which card points transfer into a mileage program
travelmaxx transfers VIRGIN_ATLANTIC --points 60000
travelmaxx transfers UNITED --cards chase,amex

Airline waitlists

Live standby/upgrade waitlist lookup for Alaska and United flights. Data is available within the ~72-hour pre-departure window. Use --track to start background monitoring and snapshot recording.

# Check the live waitlist for Alaska flights on a route
travelmaxx waitlist alaska --date 2026-12-01 --origin SEA --destination SFO

# Look up a specific United flight and start tracking
travelmaxx waitlist united --date 2026-12-01 --flight-number UA354 --track

# Compare upgrade odds across all nonstops on a route
travelmaxx recommend alaska SEA SFO --date 2026-12-01
travelmaxx recommend united EWR SFO --date 2026-12-01 --goal first_class_seat

# Mark your current flight for comparison
travelmaxx recommend alaska SEA SFO --date 2026-12-01 --flight AS1042

# View waitlist snapshot history for tracked flights
travelmaxx history alaska                                    # list tracked flights
travelmaxx history alaska --flight-number AS1042 --date 2026-12-01
travelmaxx history united --flight-number UA354 --limit 20

Command reference

travelmaxx login [--no-browser]     Sign in (browser or device code)
travelmaxx logout                   Remove saved credentials
travelmaxx whoami                   Show the signed-in account

travelmaxx search ORIGIN DEST       Search award availability
  --date YYYY-MM-DD                 Single date
  --date-range RANGE                Month/year/explicit range
  --class ECON|BUSINESS|FIRST       Cabin (default ECON)
  --programs A,B,C                  Mileage programs or ONEWORLD|STAR_ALLIANCE|SKYTEAM
  --pax N                           Passengers (default 1)
  --days-around N                   Flexible window, 0-3 days
  --sort points|duration            Sort order
  --limit N                         Max results shown
  --max-wait SECONDS                Early-return window (default 60)
  --min-results N                   Return once N fares found
  --json                            JSON to stdout
  --output-file FILE                Save full results to a file

travelmaxx alerts list|create|delete
travelmaxx discover [--limit N]

travelmaxx profile [--json]         Your cards, programs, flights
travelmaxx cards QUERY [--issuer]   Credit card catalog lookup
travelmaxx programs QUERY           Loyalty program catalog lookup

travelmaxx guides search QUERY      Search travel guides
travelmaxx guides read SLUG         Read a guide by slug

travelmaxx flights list             List saved flights
travelmaxx flights save NUM --date  Save a flight (--track to monitor)
travelmaxx flights remove NUM --date

travelmaxx transfers PROGRAM        Card-to-program transfer options
  --points N                        Compute card cost for an award
  --cards SLUGS                     Restrict to specific issuers

travelmaxx waitlist alaska|united   Live waitlist lookup
  --date YYYY-MM-DD                 Flight date (required)
  --origin IATA                     Origin airport
  --destination IATA                Destination airport
  --flight-number NUM               Specific flight
  --track                           Start background monitoring

travelmaxx recommend alaska|united ORIGIN DEST
  --date YYYY-MM-DD                 Flight date (required)
  --flight NUM                      Your current flight
  --goal upgrade|standby|first_class_seat

travelmaxx history alaska|united    Waitlist snapshot history
  --flight-number NUM               Flight (omit to list tracked)
  --date YYYY-MM-DD                 Flight date
  --limit N                         Max snapshots (default 50)

Troubleshooting

• “Subscription required” — subscribe at travelmaxx.app/subscribe.
• “No Roame account linked” — connect your Roame credentials in account settings.
• Session expired — run travelmaxx login again.
• Results marked partial — the search returned early; re-run with --max-wait 120 for exhaustive results.