| 1 | --- |
| 2 | name: flights |
| 3 | description: Track flights and look up status and schedules. Use when: flight status, track a flight, flightaware, arrivals, departures, delays, or a flight number. |
| 4 | invocation: model+user |
| 5 | --- |
| 6 | |
| 7 | # Flights |
| 8 | |
| 9 | ## When to use |
| 10 | Live status, schedules, gates, and delays for a flight the user names. |
| 11 | |
| 12 | ## Setup |
| 13 | Two paths: |
| 14 | |
| 15 | 1. **Web (no setup).** Flight number + date via web search; good enough for |
| 16 | status, terminals, and delays. |
| 17 | 2. **FlightAware AeroAPI (structured data).** Needs the user's API key, or |
| 18 | fail loud: |
| 19 | `curl -H "x-apikey: $FLIGHTAWARE_API_KEY" https://aeroapi.flightaware.com/aeroapi/flights/{ident}` |
| 20 | |
| 21 | ## Workflow |
| 22 | 1. Confirm the flight identifier and date — never guess between same-number |
| 23 | daily flights. |
| 24 | 2. Report status, scheduled vs actual times, origin/destination, and terminal/gate. |
| 25 | 3. State the timezone of every time quoted. |
| 26 | |
| 27 | ## Non-goals |
| 28 | - Do not book, change, or cancel travel. |
| 29 | - Do not look up other people's itineraries from a name alone. |
| 30 | - Do not quote times without their timezone. |
| 31 |