flight-live
Use when searching live flights, comparing airfare across dates, filtering nonstop routes, or ranking travel options.
Source facts
- Repository
- anntnzrb/agents
- Last source activity
- October 4, 2026 at 19:18
- Detected SKILL.md language
- English
- Stars
- 1
- Forks
- 0
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
File Explorer
22 filesShowing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- flight-live
- description
- Use when searching live flights, comparing airfare across dates, filtering nonstop routes, or ranking travel options.
- license
- AGPL-3.0-or-later
- compatibility
- Requires `uv` and `nix`. Uses bundled skill-local `scripts/cli.py`. Network access required.
- metadata
- {"author":"anntnzrb"}
# 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_DIR` is 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
```bash
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 `nix` in PATH (hard fail)
- `agent-browser` unavailable via nix wrapper (hard fail)
- provider execution/network failures (hard fail)
- over-constrained filters (empty shortlist with guidance in `decision.actions`)
Recovery order:
1. verify `nix` works
2. run `nix run github:numtide/llm-agents.nix#agent-browser -- --version`
3. widen date window
4. disable `--nonstop`
5. raise/remove `--max-budget`
6. relax `--stay-min/--stay-max`
## Evidence fields to trust most
Top-level:
- `warnings`
- `summary.planner_received`
- `summary.after_filters`
- `summary.returned`
- `resolved.origin.iata` / `resolved.destination.iata`
- `insights.weekend_premium_pct`
- `decision.recommendation`
Per result:
- `effective_price`
- `nonstop`
- `depart_date` / `return_date`
- `score`
- `reasons`
- `hints`
## 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 |
View on GitHub