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

To upgrade later, run travelmaxx update- it detects how you installed (pipx, uv, Homebrew, pip) and upgrades in place. Once a day, commands check your version first and print a one-line reminder to stderr when a newer release exists, so you always know when you're behind.

travelmaxx update              # upgrade to the latest release
travelmaxx update --check      # just report what's available

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.

SkyView - cached bird's-eye search

One instant read of the cached award fare database - no polling. Origins and destinations can be airports (SFO), metro city codes (NYC, TYO, LON), or continents (Europe), with windows up to 60 days. Results are cached observations, not live inventory: every fare carries an updated_at timestamp so you know how old the data is - verify with travelmaxx search before booking.

# Airport to airport across two weeks
travelmaxx skyview SFO JFK --start 2026-08-01 --end 2026-08-14

# Where in Europe can I go from NYC in business, all of August?
travelmaxx skyview NYC Europe --from-type CITY --to-type CONTINENT \
  --start 2026-08-01 --end 2026-08-30 --class BUSINESS

# All Tokyo-area airports for a month
travelmaxx skyview SFO TYO --to-type CITY --start 2026-09-01 --end 2026-09-30

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

Your airline accounts

Read the airline's own account pages with the credentials you linked in settings: miles balance, elite tier and status progress, Million Miler progress, discount and companion-fare codes, vouchers, upgrade certificates, lounge membership, wallet transactions, recent mileage activity, and upcoming trips. Alaska is served from a snapshot up to 24 hours old unless you ask for a fresh sign-in.

travelmaxx account alaska                  # cached if under 24h old
travelmaxx account alaska --fresh          # live sign-in (asks for the texted code)
travelmaxx account alaska --section certificates
travelmaxx account alaska --json           # the whole snapshot, verbatim

# Delta reads through the paired Delta companion Chrome extension
travelmaxx account companion pair
travelmaxx account delta

The texted code.A fresh Alaska sign-in pauses for the verification code Alaska sends to your phone. At a terminal you're prompted inline and the command finishes on its own. Scripts and AI agents (no TTY, or --json) get exit code 2 and continue with --otp— so an assistant driving the CLI asks you to read the code off your phone. The code is never echoed, logged, or stored.

travelmaxx account alaska --fresh --otp 123456

Book an award flight

The CLI drives a booking session on the airline's own site and stops at every step, telling you the exact next command. Pass the miles and taxes your search quoted and it stops instead of buying a re-priced award; --dry-run walks the whole flow except the purchase click.

travelmaxx book start SEA SFO --date 2026-12-01 --flight AS1042 \
  --cabin business --expected-miles 25000
travelmaxx book status                  # what it's waiting on
travelmaxx book confirm flight
travelmaxx book provide 2fa_code        # prompted without echo
travelmaxx book confirm passenger
travelmaxx book provide cvv
travelmaxx book confirm purchase        # final approval
travelmaxx book cancel

• • Alaska completes the purchase, but only after book confirm purchase.
• • Deltagoes through the companion extension and stops at Delta's final review page — it never clicks buy. You finish in your own browser.
• • One booking at a time.Starting a second returns “booking in progress”. Searches aren't limited that way — run as many travelmaxx search commands in parallel as you like, even while a booking is open.

Trips & booked flights

travelmaxx trips create "Tokyo spring 2027"
travelmaxx trips add-leg <trip-id> Outbound --origin SFO --destination NRT
travelmaxx trips get <trip-id>
travelmaxx trips select <trip-id> <option-id>
travelmaxx trips share <trip-id>

# Record a reservation you've actually booked
travelmaxx booked save AS1042 --date 2026-12-01 --origin SEA --destination SFO \
  --confirmation ABCDEF --points 25000
travelmaxx booked list

Portfolio & reference

View and update your profile, log points earnings and redemptions, look up cards and loyalty programs, read travel guides, manage your saved flights, and check transfer partners. Any balance change through profile points is recorded as a points transaction.

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

# Tell TravelMaxx about yourself in plain English
travelmaxx profile update "I have Alaska MVP Gold and a Sapphire Reserve"

# Log a transaction: set a balance, or apply a change
travelmaxx profile points "Alaska Mileage Plan" --set 142500
travelmaxx profile points skymiles --delta -60000

# Home airports and whose points count in your totals
travelmaxx profile airports SFO SJC        # --add / --remove to amend
travelmaxx profile holder "Mom" --exclude

# 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

Airline fares, status matches & research

# Award fares straight from the airline for one date
travelmaxx fares alaska SFO LAX --date 2026-09-12
travelmaxx fares jetblue JFK LAX --date 2026-09-12

# Cheapest day in a month
travelmaxx calendar alaska SFO LAX --month 2026-09

# The two Alaska commands fetch from your own machine by default, so they
# never queue behind other users. --fetch server asks travelmaxx.app to
# fetch instead (can answer from a recent cached result).
travelmaxx fares alaska SFO LAX --date 2026-09-12 --fetch server

# Which programs will match the status you already hold
travelmaxx status match ALASKA --from "Delta Platinum"
travelmaxx status image ALASKA "MVP Gold"

# Search the web for current loyalty news
travelmaxx web-search "alaska mileage plan award chart change"

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 update [--check]          Upgrade the CLI to the latest release

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 skyview ORIGIN DEST      Instant cached availability (SkyView)
  --start / --end YYYY-MM-DD        Window (max 60 days)
  --from-type / --to-type TYPE      AIRPORT | CITY | CONTINENT
  --class, --programs, --pax        Same as search
  --max-stops N                     Cap connections
  --sort, --limit, --json           Output controls

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

travelmaxx profile [--json]         Your cards, programs, flights
travelmaxx profile update TEXT      Save facts about you in plain English
travelmaxx profile points TARGET    --set N | --delta N [--holder NAME]
travelmaxx profile airports IATA... --add | --remove (default: replace)
travelmaxx profile holder NAME      --exclude from your point totals
travelmaxx cards QUERY [--issuer]   Credit card catalog lookup
travelmaxx programs QUERY           Loyalty program catalog lookup

travelmaxx account alaska           Live Alaska account sweep
  --fresh                           Sign in again instead of the 24h snapshot
  --otp CODE                        Continue a sign-in non-interactively
  --cancel                          Abandon a sign-in awaiting a code
  --section SECTION                 summary|status|certificates|activity|wallet|trips
  --no-save                         Don't sync the snapshot to your profile
travelmaxx account delta            Delta account via the companion extension
travelmaxx account companion [ACTION]  status | pair | disconnect

travelmaxx book start ORIGIN DEST   Open a booking session (one at a time)
  --date YYYY-MM-DD                 Departure date (required)
  --airline alaska|delta            Airline (default alaska)
  --flight NUM                      Flight number(s)
  --cabin, --pax                    Cabin and passenger count
  --expected-miles / --expected-taxes  Stop if the price drifted
  --dry-run                         Everything except the purchase click
travelmaxx book status              What the session needs next
travelmaxx book confirm STEP        flight|sign_in|passenger|payment|purchase
travelmaxx book provide KIND [VALUE]  2fa_code|cvv (prompted without echo)
travelmaxx book cancel              Abandon the open booking

travelmaxx trips list|get|create|add-leg|select|share
travelmaxx booked list|save|remove   Confirmed reservations

travelmaxx fares alaska|jetblue ORIGIN DEST --date
travelmaxx calendar alaska ORIGIN DEST --month
  --fetch local|server               Who requests the fares from Alaska
                                     (default local: your own connection)
travelmaxx status match PROGRAM [--from STATUSES]
travelmaxx status image PROGRAM STATUS
travelmaxx web-search QUERY

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 award search tool account linked” - connect your award search account 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.
• “Booking in progress” - you already have a booking open. Finish it, or run travelmaxx book cancel. Searches are unaffected.
• Alaska asks for a code every time- that's Alaska's 2FA. Skip --fresh to read the cached snapshot without signing in again.