legio-monitor 0.1.0

A legion of always-on-top, themeable desktop monitors. Module #1: live Claude usage.

Legio.Monitor

A legion of small, always-on-top, themeable desktop monitors that share one window, theme engine, and config. Module #1: Legio.Monitor | Claude — live Claude usage at a glance.

Legio.Monitor | Claude shows your live Claude limits — current session, weekly (all-models, Opus, Sonnet), API spend, and prompt-cache hit rate — with live reset countdowns, burn-rate ETAs ("full in 3.2h at this rate"), and a trend chart. Pick which metrics appear, theme the colours, and choose where the numbers come from, all from a single TOML config.

⚠️ Unofficial community tool. Not affiliated with Anthropic.

Features

• Configurable scope — choose which limits/metrics to show, in what order.
• Two data sources — scrape_web (your claude.ai usage page, default) and admin_api (official Anthropic Admin Usage/Cost Report API for token/$/cache).
• Themeable — warm-dark default plus light, high-contrast, nord, dracula, custom palettes, and optional follow-the-OS light/dark.
• Always-on-top, resizable, ghost (click-through) mode, live countdowns, alerts.

Getting Started

Install

pipx install legio-monitor          # API-only
pipx install "legio-monitor[scrape]"  # + Playwright for the scrape source

Or grab the prebuilt Windows .exe from Releases.

Run

legio setup     # first-run: pick metrics, theme, and source (login/key)
legio           # launch the monitor

For the admin_api source, set ANTHROPIC_ADMIN_KEY (see .env.example).

Build the .exe locally (Windows)

git clone https://github.com/johannesgrobler-73/legio-monitor
cd legio-monitor
.\scripts\build_exe.ps1

Produces dist\Legio.Monitor.exe — a windowed build (no console, app icon included) that launches straight into the widget. Uses packaging/legio.spec.

Documentation

• docs/SCOPE.md — full design brief & architecture
• docs/CONFIG.md — every config option
• docs/DESIGN.md — geometry/visual spec
• docs/EXTENDING.md — add a metric, source, theme, or monitor

Contributing

See CONTRIBUTING.md for branch/commit conventions, local dev setup, and the PR flow.

License

Apache-2.0.