terminal · gate · no boarding pass required

✈ gfly

Google Flights for agents. A read-only, JSON-first flight-search CLI an LLM can drive.

no API key · no account · no OAuth

$ uvx gfly search JFK LHR --depart 2026-08-15

GitHub → PyPI Docs

gfly demo: airports search, schema, validation, agent

Built for the agent loop

JSON by default

Stable, versioned schemaVersion envelope when piped. Tables for humans at a TTY.

Self-describing

gfly schema and an embedded gfly agent contract — zero external files.

Semantic exit codes

Real failures get real codes: BLOCKED, SCHEMA_DRIFT, RATE_LIMITED + retryAfterSeconds.

Token-bounded

--limit / --offset / --select so an agent never drowns in 40 itineraries.

Polite by design

A persistent, cross-process throttle that survives the fresh-process-per-call model.

Read-only

It searches. It cannot book or mutate anything. Safe to hand an autonomous agent.

Gate status — exit codes

0	ok	7	rate limited
2	usage / parse	8	retryable (transient)
3	empty results	13	input required
4	auth required	20	BLOCKED (CAPTCHA / soft-block)
5	not found	21	SCHEMA_DRIFT (upstream changed)

gfly · read-only Google Flights CLI · MIT OR Apache-2.0 · rnwolfe/gfly
The default backend rides a reverse-engineered, undocumented endpoint — fragile by nature. That's why every failure is a structured, actionable error.