flight-live
Operator manual for the bundled read-only flight CLI.
Credentials
No credentials. No API keys. No commercial APIs.
Entry points
- From skill root:
uv run --script <skill-dir>/scripts/cli.py ... - From anywhere:
uv run --script "$SKILLS_DIR/flight-live/scripts/cli.py" ... - If
SKILLS_DIRis not set:uv run --script <skill-dir>/scripts/cli.py ... - For process integration:
uv run --script <skill-dir>/scripts/cli.py --mode rpc
Core rule
Prefer --llm-json unless user asks for human text.
Fast pattern
uv run --script <skill-dir>/scripts/cli.py \
--origin GYE \
--destination MIA \
--depart-start 2026-08-01 \
--depart-end 2026-10-31 \
--trip-type roundtrip \
--stay-min 4 \
--stay-max 10 \
--llm-json
Failure handling
Common failures:
- missing
nixin PATH (hard fail) agent-browserunavailable via nix wrapper (hard fail)- provider execution/network failures (hard fail)
- over-constrained filters (empty shortlist with guidance in
decision.actions)
Recovery order:
- verify
nixworks - run
nix run github:numtide/llm-agents.nix#agent-browser -- --version - widen date window
- disable
--nonstop - raise/remove
--max-budget - relax
--stay-min/--stay-max
Evidence fields to trust most
Top-level:
warningssummary.planner_receivedsummary.after_filterssummary.returnedresolved.origin.iata/resolved.destination.iatainsights.weekend_premium_pctdecision.recommendation
Per result:
effective_pricenonstopdepart_date/return_datescorereasonshints
RPC usage
Use RPC for strict JSONL envelopes (ping, get_schema, search).
Required follow-up reads
| Need | Read | When |
|---|---|---|
| Search commands and trusted fields | references/cheatsheet.md |
Constructing or interpreting a search |
| Decision workflow | references/workflows.md |
Comparing options or presenting recommendations |
| JSONL request and response contract | references/rpc.md |
Using --mode rpc |
| Failure diagnosis | references/troubleshooting.md |
Any provider, filter, or RPC failure |