clawflight

# ✈️ ClawFlight Skill

AI-first flight search that finds flights with Starlink internet. Built for business travelers and digital nomads who need to work on long-haul flights.

## What It Does

- 🔍 **Search flights** between any airports
- 🛜 **Filter Starlink** — only shows flights with Starlink-equipped airlines
- ⭐ **Rank by priority** — WiFi quality, price, duration, or jet lag friendliness
- 🔗 **Affiliate links** — direct booking links (Kiwi.com + Skyscanner)
- 📊 **Rate flights** — submit WiFi quality ratings (speed, reliability, ease)
- ⏰ **Post-flight nudge** — save flights, get prompted 6h after landing

## Setup

```bash
# Install dependencies
cd ~/clawd/projects/clawflight/skill
npm install

# Get a FREE Amadeus API key (no credit card required):
# 1. Go to https://developers.amadeus.com/self-service
# 2. Register → Create App → copy Client ID + Secret
# 3. Set environment variables:

export AMADEUS_CLIENT_ID="your_client_id"
export AMADEUS_CLIENT_SECRET="your_client_secret"

# Optional: use production data (requires moving to production in Amadeus portal)
export AMADEUS_ENV=production
```

The WiFi ratings database is maintained by ClawFlight — you only need to provide your own Amadeus key for live flight data. No other API key required.

## Commands

### Find a flight

```
clawflight search --from BKK --to LHR --date 2026-03-14 --priority wifi
```

Options:
- `--from, -f` — Origin IATA code (e.g., BKK, LHR, SFO)
- `--to, -t` — Destination IATA code
- `--date, -d` — Departure date (YYYY-MM-DD)
- `--priority, -p` — Sort by: `wifi` (default), `cheap`, `fast`, `jetlag`
- `--adults, -a` — Number of passengers (default: 1)
- `--json` — Output machine-readable JSON

### List Starlink airlines

```
clawflight airlines
```

Shows all airlines in the database with WiFi scores and fleet coverage.

### Save a flight (for post-flight rating)

```
clawflight save --flight UA123 --arrival 2026-03-15T14:30:00Z
```

Saves flight info. A cron job will nudge you 6 hour...