--- title: "Codex Usage" description: "Codex Usage is a Marketplace integration for Home Assistant. It has 67 installs sharing analytics, needs the vendor's cloud and was last updated October 25, 2026." canonical: "https://vulpo.app/integrations/marketplace/lucafsmart-codex-usage" url: "https://vulpo.app/integrations/marketplace/lucafsmart-codex-usage.md" last-updated: "2026-10-25" version: "1.4" --- # Codex Usage > Codex Usage is a Marketplace integration for Home Assistant. It has 67 installs sharing analytics, needs the vendor's cloud and was last updated October 25, 2026. Codex Usage is a read-only integration that tracks ChatGPT Codex usage limits and reset times in Home Assistant. It adds sensors for the plan, five-hour and weekly usage, remaining amounts, reset times, usage budgets, available resets and credit balance, plus binary sensors for reached rate, spend and credit limits. Windows are taken from what OpenAI reports instead of being guessed from the plan name, and unknown values are never shown as zero. A bundled English and German dashboard card is registered automatically for storage-managed dashboards. Several accounts or workspaces can be added, and options cover the update interval, profile statistics and saved-reset details. It connects to the vendor cloud, uses a device-code login set up in the UI, and never purchases credits, redeems resets or sends prompts. Automatic summary of the README and code of LucaFSmart/codex-usage. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=LucaFSmart&repository=codex-usage&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=LucaFSmart&repository=codex-usage&category=integration) ## Supports - **Uses the vendor's cloud**: Needs an internet connection and an account with the vendor. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Authorize Codex Usage - **I completed authorization** Also asked when signing in again. ### Select a ChatGPT workspace - **Workspace** ### After setup - **Update interval (seconds)** - **Fetch profile statistics** - **Fetch saved-reset details** Texts from the code of [LucaFSmart/codex-usage](https://github.com/LucaFSmart/codex-usage). ## Entities - **Binary sensors**: Rate limit reached, Credits available, Unlimited credits, Credit overage limit reached, Spend limit reached - **Sensors**: Plan, 5-hour usage, 5-hour remaining, 5-hour reset, 5-hour usage budget, Weekly usage, Weekly remaining, Weekly reset, Weekly usage budget, Weekly usage pace, Available resets, Credit balance, and 20 more ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **Repair notices**: Notices it can show in Settings, Repairs: Codex Usage card resource could not be registered ## From the README > Codex Usage is a read-only Home Assistant integration for reported Codex and other eligible agentic allowances included with ChatGPT plans. It monitors reported usage windows, reset times, feature restrictions and optional account data, and includes an English/German dashboard card. ChatGPT Work and Codex share usage; other eligible agentic features can share the allowance when their pricing takes effect. Eligibility depends on the plan and workspace. A change cannot be attributed to a particular app, model, task or conversation. From the README of [LucaFSmart/codex-usage](https://github.com/LucaFSmart/codex-usage#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [AI and voice](https://vulpo.app/integrations/category/ai-and-voice.md), AI models - Number: 67 installs sharing analytics; 7 GitHub stars - Connection: Needs the vendor's cloud - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: 0.7.6, last updated October 25, 2026 - Domain: `codex_usage` - Source: - Issues: - Screenshot: https://vulpo.app/integrations-img/28ae6134d8d1e6b4.webp (from LucaFSmart/codex-usage's README) - Screenshot: https://vulpo.app/integrations-img/54f75fbe11e673ac.webp (from LucaFSmart/codex-usage's README) In Vulpo: Chart card, Apple Watch Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-25. Source: https://vulpo.app/integrations/marketplace/lucafsmart-codex-usage --- - HTML version of this page: https://vulpo.app/integrations/marketplace/lucafsmart-codex-usage - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml