avios-cli

A CLI and TUI for your Avios programmes — check balances, browse transactions, and search British Airways reward-flight availability without leaving the terminal. British Airways, Iberia, and Aer Lingus use avios.com; Finnair Plus uses Finnair's own OAuth and loyalty API.

⚠️ Unofficial. This project is not affiliated with, authorised by, or endorsed by Avios, British Airways, Finnair or IAG Loyalty. It drives the same private endpoints the providers' websites use, with your own logged-in session. Use at your own risk; it may break at any time and may be against the provider's terms of service.

_{The avios tui dashboard (demo data). Regenerate with uv run python scripts/screenshot.py.}

_{Direct BA reward-seat availability by date and cabin (synthetic demo data).}

Status

Early alpha, built in the open. See the roadmap.

Install

Requires Python 3.10+.

uvx avios-cli --help     # run without installing
# or install it, then use the `avios` command:
pip install avios-cli
avios --help

Or from source, for development:

git clone https://github.com/alexechoi/avios-cli
cd avios-cli
uv sync
uv run avios --help

Log in

avios.com has no credential API — login is Auth0 Universal Login behind hCaptcha and SMS/passkey MFA — so avios login opens a real browser, waits while you finish logging in (password, captcha, SMS code), and captures the session once you land on the dashboard. It needs the login extra:

uvx --from 'avios-cli[login]' avios login
uvx --from 'avios-cli[login]' avios login finnair

It launches your installed Google Chrome (no extra download). If you don't have Chrome, install Playwright's browser once with uvx --from playwright playwright install chromium.

Prefer not to open a browser? Import the cookie from a Chrome you're already logged into avios.com with:

uvx --from 'avios-cli[login]' avios login --from-browser

This scans all your Chrome profiles and uses whichever one is actually logged into avios.com (it tells you which). If you have several profiles, you can target one directly:

uvx --from 'avios-cli[login]' avios login --from-browser --profile "Profile 1"

Plain uvx avios-cli login won't work — the isolated environment doesn't include the login extra.

Stuck in an endless captcha loop? That's bot detection on the automated browser. Use --from-browser instead: log into avios.com in your normal Chrome (you'll get one normal captcha), then run uvx --from 'avios-cli[login]' avios login --from-browser.

Finnair uses a different CAS/OAuth flow. avios login finnair opens the Finnair Plus balance page, lets you complete password and MFA in the real browser, and captures the OAuth session from the authenticated loyalty request. --from-browser is not available for Finnair because browser-cookie import cannot read that token.

Each programme session is stored at ~/.config/avios/accounts/<programme>.json (mode 600). Sessions expire; just log in to that programme again. Use avios logout <programme> for one account or avios logout for all accounts. For BA, browser-assisted login also opens the reward-flight finder briefly so its separate spend-avios session is captured.

Usage

Commands span all logged-in accounts by default and show a combined total; add --account/-a <programme> to focus on one.

avios accounts                 # every logged-in account: balance + status
avios balance                  # per-account balances + combined total
avios transactions --limit 20  # recent transactions, merged across accounts
avios pending                  # pending Avios, merged across accounts
avios balance --account iberia # just one programme
avios overview                 # dashboard summary
avios whoami                   # name, tier, membership, email
avios raw /shell/api/users/current/accounts   # hit any endpoint directly

# Direct British Airways reward-seat availability:
avios flights LON ABZ --date 2026-11-05
avios flights LON ABZ --date 2026-11-05 --return-date 2026-11-12
avios flights LON ABZ --month 2026-11 --cabin economy --cabin business
avios flights LON ABZ --month 2026-11 --return-month 2026-12 --json

Add --json to accounts, balance, transactions, pending, whoami, or flights for scriptable output. With a single account, balance keeps the individual/household breakdown.

TUI

avios tui

A tabbed full-screen application:

• Dashboard — combined balance header and transactions across every account.
• Reward Flights — BA date/calendar search with optional reverse-route return, cabin/passenger controls, and independent outbound/inbound result tables.

Press r to refresh the dashboard and q to quit. Reward searches run only when you press Search or Enter.

Reward search is an unofficial, availability-only view. It currently supports direct BA flights, three-letter airport/city codes, and seat counts by cabin. It does not price, book, or show taxes/fees or connecting flights. Return journeys are two independent one-way searches.

Roadmap

• Project scaffolding, packaging and CI
• Session + cookie storage layer
• Typed API client (balance, transactions, accounts, profile)
• Browser-assisted avios login
• CLI commands
• Textual TUI dashboard
• Multiple accounts (BA, Iberia, Aer Lingus, Finnair) with combined views
• British Airways reward-flight availability search (CLI + TUI)

Development

uv sync            # installs the project + the `dev` dependency-group
uv run ruff check .
uv run mypy src
uv run pytest

See CONTRIBUTING.md for the full workflow and CHANGELOG.md for release notes.

Security

No passwords are handled or stored — only programme session cookies or OAuth tokens, kept locally under ~/.config/avios/accounts/ (mode 600). See SECURITY.md.

License

MIT