avios-cli 0.1.2

A CLI and TUI for avios.com — view your Avios balance and transactions from the terminal.

avios-cli

A CLI and TUI for avios.com — check your Avios balance, browse your transactions and manage your account without leaving the terminal.

⚠️ Unofficial. This project is not affiliated with, authorised by, or endorsed by Avios, British Airways or IAG Loyalty. It drives the same private endpoints the avios.com website uses, 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.}

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 rides a real browser session (like gh/aws login). Login needs the login extra, so run it with avios-cli[login]:

# open a browser and log in once (first run also downloads Chromium):
uvx --from 'avios-cli[login]' playwright install chromium
uvx --from 'avios-cli[login]' avios login

# ...or skip the browser download and import the cookie from Chrome you're
# already logged into avios.com with:
uvx --from 'avios-cli[login]' avios login --from-browser

If you installed with pip install "avios-cli[login]", just run avios login (and playwright install chromium once). Plain uvx avios-cli login won't work — the isolated environment doesn't include the login extra.

Your session cookie is stored at ~/.config/avios/state.json (mode 600). It expires after ~a day; just run avios login again. Run avios logout to remove it.

Usage

avios balance                  # your Avios balance
avios transactions --limit 20  # recent transactions
avios pending                  # pending Avios
avios accounts                 # linked loyalty accounts
avios overview                 # dashboard summary (raw JSON)
avios whoami                   # your profile (raw JSON)
avios raw /manage-avios/api/user/current   # hit any endpoint directly

Add --json to balance, transactions, pending or accounts for scriptable output.

TUI

avios tui

A full-screen dashboard: your balance in the header and a scrollable transactions table. Press r to refresh, q to quit.

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
• Reward-flight availability search (coming soon — needs a British Airways capture)

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 your session cookie, kept locally at ~/.config/avios/state.json (mode 600). See SECURITY.md.

License

MIT