Metadata-Version: 2.4
Name: legio-monitor
Version: 0.1.0
Summary: A legion of always-on-top, themeable desktop monitors. Module #1: live Claude usage.
Project-URL: Homepage, https://github.com/johannesgrobler-73/legio-monitor
Project-URL: Issues, https://github.com/johannesgrobler-73/legio-monitor/issues
Author: Johannes Grobler
License-Expression: Apache-2.0
License-File: LICENSE
License-File: NOTICE
Keywords: anthropic,claude,desktop,monitor,usage,widget
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Win32 (MS Windows)
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Requires-Python: >=3.12
Provides-Extra: api
Requires-Dist: httpx>=0.27; extra == 'api'
Provides-Extra: dev
Requires-Dist: pyinstaller>=6; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.5; extra == 'dev'
Provides-Extra: scrape
Requires-Dist: playwright>=1.40; extra == 'scrape'
Description-Content-Type: text/markdown

# 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
```bash
pipx install legio-monitor          # API-only
pipx install "legio-monitor[scrape]"  # + Playwright for the scrape source
```
Or grab the prebuilt Windows `.exe` from [Releases](https://github.com/johannesgrobler-73/legio-monitor/releases).

### Run
```bash
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)
```powershell
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`](packaging/legio.spec).

## Documentation
- [docs/SCOPE.md](docs/SCOPE.md) — full design brief & architecture
- [docs/CONFIG.md](docs/CONFIG.md) — every config option
- [docs/DESIGN.md](docs/DESIGN.md) — geometry/visual spec
- [docs/EXTENDING.md](docs/EXTENDING.md) — add a metric, source, theme, or monitor

## Contributing
See [CONTRIBUTING.md](CONTRIBUTING.md) for branch/commit conventions, local
dev setup, and the PR flow.

## License
[Apache-2.0](LICENSE).
