Quick Reference
| Topic |
File |
| Search, compare, flexible dates |
search.md |
| Booking, rebooking, disruptions |
booking.md |
| Price alerts, tracking, predictions |
tracking.md |
| Miles, points, status, awards |
points.md |
| APIs, integrations, data sources |
apis.md |
User Profile
Preferences persist in ~/flight/memory.md. Create on first use.
## Home Airports
<!-- Primary airports. Format: "IATA, IATA" -->
<!-- Examples: MAD, BCN | JFK, EWR, LGA -->
## Preferred Airlines
<!-- Airlines or alliances. Format: "airline | alliance" -->
<!-- Examples: Iberia, BA | Star Alliance | any -->
## Elite Status
<!-- Loyalty tiers. Format: "program: tier" -->
<!-- Examples: BA Gold, United 1K, Marriott Platinum -->
## Budget Style
<!-- budget | moderate | premium | business-class -->
## Travel Style
<!-- solo | couple | family-with-kids | business-frequent -->
## Carry-On Only
<!-- yes | no | prefer -->
Empty sections = ask when relevant. Fill as you learn.
Data Storage
Store flight data in ~/flights/:
- searches — saved route searches with price history
- bookings — active reservations with PNRs
- alerts — price drop thresholds by route
- history — past flights for loyalty tracking
Core Rules
- Always compare 3+ platforms before recommending (Skyscanner, Google Flights, Kiwi, direct airline)
- Calculate TRUE total cost including baggage, seat selection, and fees — especially for budget carriers
- Check visa requirements before booking international flights
- For families: verify adjacent seat availability before booking, not after
- Set price alerts on flexible dates (±3 days) for better deal coverage
- Track flight status starting 24h before departure — proactive rebooking on delays
- Never book non-refundable for trips >30 days out without asking
- When comparing award bookings: calculate cents-per-point against cash price
- Warn about tight connections (<90min domestic, <2h international)
- For multi-city: check if separate bookings are cheaper than one ticket
1---2name: flight3description: Search, compare, book, and manage flights with price tracking, multi-platform comparison, and loyalty optimization.4---5
6## Quick Reference
7
8| Topic | File |
9|-------|------|
10| Search, compare, flexible dates | `search.md` |
11| Booking, rebooking, disruptions | `booking.md` |
12| Price alerts, tracking, predictions | `tracking.md` |
13| Miles, points, status, awards | `points.md` |
14| APIs, integrations, data sources | `apis.md` |
15
16## User Profile
17
18Preferences persist in `~/flight/memory.md`. Create on first use.
19
20```markdown
21## Home Airports
22<!-- Primary airports. Format: "IATA, IATA" -->
23<!-- Examples: MAD, BCN | JFK, EWR, LGA -->
24
25## Preferred Airlines
26<!-- Airlines or alliances. Format: "airline | alliance" -->
27<!-- Examples: Iberia, BA | Star Alliance | any -->
28
29## Elite Status
30<!-- Loyalty tiers. Format: "program: tier" -->
31<!-- Examples: BA Gold, United 1K, Marriott Platinum -->
32
33## Budget Style
34<!-- budget | moderate | premium | business-class -->
35
36## Travel Style
37<!-- solo | couple | family-with-kids | business-frequent -->
38
39## Carry-On Only
40<!-- yes | no | prefer -->
41```
42
43*Empty sections = ask when relevant. Fill as you learn.*
44
45## Data Storage
46
47Store flight data in ~/flights/:
48- searches — saved route searches with price history
49- bookings — active reservations with PNRs
50- alerts — price drop thresholds by route
51- history — past flights for loyalty tracking
52
53## Core Rules
54
55- Always compare 3+ platforms before recommending (Skyscanner, Google Flights, Kiwi, direct airline)
56- Calculate TRUE total cost including baggage, seat selection, and fees — especially for budget carriers
57- Check visa requirements before booking international flights
58- For families: verify adjacent seat availability before booking, not after
59- Set price alerts on flexible dates (±3 days) for better deal coverage
60- Track flight status starting 24h before departure — proactive rebooking on delays
61- Never book non-refundable for trips >30 days out without asking
62- When comparing award bookings: calculate cents-per-point against cash price
63- Warn about tight connections (<90min domestic, <2h international)
64- For multi-city: check if separate bookings are cheaper than one ticket