Repository navigation
Releases: alves-dev/ai-usage
Releases · alves-dev/ai-usage
Release list
v2026.8.1-dev-5f99cc8
v2026.8.1-dev
This is a development release from develop.
v2026.8.1
Fixed
- Redacted webhook IDs from invalid-payload logs and sensor state attributes.
- Moved provider image and Lovelace card file checks off the event loop.
- Updated account devices to reference their parent device by registry ID.
v2026.8.0
Changed
- Replaced the provider-specific payload with schema
2.0, using
collector_data,account_data.idand normalizedusage_data.windows. - Replaced Codex/Ollama-specific usage entities with dynamic window entities.
- The integration now derives available percentage and account availability
from normalized windows. - Provider metadata and entity images are resolved internally from the
provider identifier;provider_datais no longer part of the payload.
Added
- Added
scripts/manual_collector.pyand its usage documentation for manual
webhook testing. - Added the AI Usage Windows Lovelace card to the integration and registered it
automatically in the Home Assistant frontend.
v2026.8.0-dev
This is a development release from develop.
v0.0.3
Atention !!!
Payload contract changed
Changed
- Updated the Codex payload contract to schema
1.1. - Replaced the ambiguous
primary_windowandsecondary_windowfields with
semanticfive_hour_windowandweekly_windowfields. - Allowed either Codex usage window to be
nullwhen the provider does not
report it; the integration no longer copies one window into the other. - This is a breaking contract change. Collectors must send schema
1.1; the
integration does not support the previous window field names.
Added
- Added an example Home Assistant Lovelace custom card for displaying two AI
usage windows with available percentage and reset timestamps.
v0.0.2
Added
- Added available percentage sensors for Codex and Ollama Cloud usage windows.
- Added
sensor.last_sample_agefor account staleness tracking. - Added README tables explaining Home Assistant entities and status/limit
signals.
Changed
- Changed Codex reset-after duration sensors to show hours instead of raw
seconds. - Renamed Codex primary/secondary window entities to 5-hour and weekly usage
limit entities. - Changed percentage sensors to use zero decimal places by default.
- Changed low-level diagnostic entities to be disabled by default.
- Documented the beta status before
v1.0.0and clarified entity contract
stability expectations.
v0.0.1
Added
- Initial HACS-ready release of IA Usage.
- Added Home Assistant webhook ingestion for normalized AI usage payloads.
- Added support for Codex usage payloads.
- Added support for Ollama Cloud usage payloads.