// readme

Codex Usage Card

Track your Codex usage directly in the sidebar.

Codex Usage Card is an unofficial macOS add-on for the Codex desktop app. It displays your remaining usage allowance as compact progress rings in the sidebar, without adding a separate app icon.

Status: v0.9.5 Beta publicly released on 2026-11-04 ยท macOS only ยท UI55. This is the final planned version; continued maintenance and compatibility with future Codex versions are not promised. The helper is ad-hoc signed and not Apple-notarized. This project is not affiliated with or endorsed by OpenAI. The v0.9.4 Beta Release remains available.

Features

  • Remaining usage as a percentage, not context-window size or conversation tokens.
  • Separate 5-hour and weekly usage rings when the account and available rate-limit data support them. Other accounts may show one ring or unavailable data.
  • Reset-time details on hover or keyboard focus, when provided by the client.
  • Light and dark themes, accessible focus behavior, and a compact sidebar layout. -โ€ฆ