Architecture
How OpenUsage discovers tools, polls providers via the daemon, and renders snapshots in the TUI.
Auto-detection
How OpenUsage discovers AI tools and API keys on first run, and how detected accounts merge with manual configuration.
Providers
What a provider is in OpenUsage, the three categories, and how each one shapes its own dashboard and detail widgets.
Accounts
The AccountConfig model, how api_key_env points to a variable name not a value, and how to track multiple accounts of the same provider.
Snapshots
The UsageSnapshot data model, what metrics it carries, refresh cadence, and how time-window filtering works.
Telemetry pipeline
How the daemon stores events, deduplicates them, and turns them into snapshots — events, sources, dedup, and retention.
Time windows
How OpenUsage filters aggregations by time, the difference between calendar 1d and rolling windows, and how retention bounds what you can query.
Themes
18 bundled themes, how to cycle them, and where external theme files live.