getaway

Plans award trips with judgment — flights across 28 mileage programs via seats.aero, hotel award stays via rooms.aero. Triggers on the dense trip ask — "I want to go away for roughly a week... warm, beachy, cheap points tickets for business class... avoid the common places we always go like seoul or tokyo" — and whenever the user wants to plan a flight or trip on points or miles, find award availability between airports or across a region ("west coast to Asia"), plan a round trip or open jaw in one pass, get creative with routings (lie flat on points to a hub like NRT with a cash hop onward, two awards stitched across programs), find hotel award nights at the destination, weigh how interesting the layover city is, price a cash positioning flight, compare mileage programs for a route, pull booking links or taxes for an award, or resume a trip already in planning — or mentions seats.aero or rooms.aero. Needs a seats.aero Pro API key, from SEATS_AERO_API_KEY or a 1Password reference in ~/.getaway/preferences.jso

Sets up getaway travel preferences. Triggers when the user wants to set up getaway ("set up getaway", "set up my travel preferences", "run getaway onboarding") or to record airports, airline and hotel points balances, elite statuses, status goals, travel instruments (airline eCredits, vouchers, companion certificates, hotel free-night certificates), credit cards held (Amex Platinum, Chase Sapphire Reserve), travel documents (passports, residency, standing visas), layover preferences (minimize or explore, connection floor, long-stop cities), or avoid lists for award planning. Auto-fills from AwardWallet, Gmail, and logged-in airline and bank sites; nothing is written until the form's Submit. Refreshing balances already on file is /getaway:refresh.

Refreshes getaway points, miles, elite statuses, and travel instruments. Triggers when the user wants to refresh or update balances ("refresh my balances", "update my Aeroplan balance", "how many points do I have now"), re-check elite status, pull current credit-card points — Amex Membership Rewards, Chase Ultimate Rewards, Citi ThankYou, Capital One miles — refresh hotel points (Hyatt, Hilton, Marriott, IHG, Choice, Wyndham), or re-check travel instruments ("refresh my credits", "what credits are expiring", companion certificates, hotel free nights), or pull balances from AwardWallet ("refresh from AwardWallet", "pull my AwardWallet balances"). Reads AwardWallet first when a key is on file, then logged-in airline, hotel, and bank sites, with a Gmail statement fallback for banks and a Gmail mining pass for instruments. First-time setup is /getaway:onboard.