Introduction
# Flight Search
Search real-time flight schedules and prices via Google Flights data.
## Prerequisites
```bash pip install fast-flights ```
The `flights-search` CLI is installed at `~/.local/bin/flights-search`.
## CLI Usage
```bash flights-search <origin> <destination> <date> [options] ```
### Examples
```bash # Basic search (auto-shows fewest stops available) flights-search YYZ EWR 2026-02-06
# Nonstop flights only flights-search YYZ JFK 2026-02-06 --nonstop
# Filter by departure time (24h format) flights-search YYZ EWR 2026-02-06 --after 18 # After 6pm flights-search YYZ EWR 2026-02-06 --before 12 # Before noon flights-search YYZ EWR 2026-02-06 --after 9 --before 14
# Cabin class flights-search YYZ EWR 2026-02-06 --class economy # default flights-search YYZ EWR 2026-02-06 --class premium # premium economy flights-search YYZ EWR 2026-02-06 --class business flights-search YYZ EWR 2026-02-06 --class first
# Get Google Flights booking link flights-search YYZ EWR 2026-02-06 --class business --link
# Multiple passengers flights-search YYZ EWR 2026-02-06 --passengers 2
# Show all flights (ignore stop minimization) flights-search YYZ EWR 2026-02-06 --all-stops ```
### Options
| Option | Description | |--------|-------------| | `--nonstop` | Force nonstop only | | `--all-stops` | Show all flights regardless of stops | | `--after HH` | Depart after hour (24h format) | | `--before HH` | Depart before hour (24h format) | | `--class` | Cabin: economy, premium, business, first | | `--passengers N` | Number of travelers | | `--link` | Print Google Flights URL |
## Default Behavior
By default, the CLI shows only flights with the **minimum stops available**: - If nonstops exist → shows only nonstops - If no nonstops → shows only 1-stop flights - Use `--all-stops` to see everything
## Output
``` Depart Arrive Airline Price Duration ---------------------------------------------------------------------------------------------------- 6:00 PM Fri, Feb 6 7:38 PM Fri, Feb 6 Air Canada $361 1 hr 38 min 9:10 PM Fri, Feb 6 10:48 PM Fri, Feb 6 Air Canada $361 1 hr 38 min
2 nonstop flight(s) found. ```
## Data Source
Uses Google Flights data via the `fast-flights` library (reverse-engineered protobuf API). No API key required.
## Notes
- Date format: `YYYY-MM-DD` - Airport codes: Standard IATA codes (JFK, LAX, YYZ, etc.) - Prices are in USD - Times shown in local airport timezone