CodexSatellites

Made for macOS

Keep your quota
in sight.

Your remaining Codex quota, beside the MacBook notch. A glance is all it takes.

ReleasesTry the satellites
CodexSatellites app icon: two orbital arcs around a central notch

A little space. A clear picture.

Left is your 5-hour quota. Right is your weekly quota. Both show what remains.

2

Interactive simulation with example values. Hover to reveal percentages. Click either satellite for settings.

Glance, then carry on.

The satellites expand on hover and retract when you leave, without taking keyboard focus.

Just enough control.

Launch at Login, 1 / 5 / 15 minute checks, available resets, and Quit. Settings dismiss after three idle seconds.

At home on
your desktop, too.

Keep both quotas on your desktop or in Notification Center. Choose Small for a glance, Medium for reset times too.

Click the widget’s content to show the app’s latest cached reading. Clicking its outer margin opens the app. On a Mac without usable notch satellites, the widget still works while the app runs, but there is no alternate in-app Settings window or menu bar item.

Dark desktop surface behind the widget layout illustrations
Codex
62%5-hour
41%Weekly
Codex
62%5-hourReset in 2 hours
41%WeeklyReset in 4 days
Small + Medium · Simulated layouts and values

Know when things change.

Native notifications mark quota resets, drops below 10%, and changes to available reset credits.

If a check fails, the last good reading dims. Unknown reset counts stay unknown. You can manage notifications in macOS System Settings.

Your Codex sign-in.
Already taken care of.

Sign in through Codex as usual. CodexSatellites reads that local login to request your quota from OpenAI.

Read-only by design

No separate login, credential storage, or changes to your Codex auth file. Reset credits are displayed, never consumed.

No extra audience

No analytics, remote telemetry, usage tracking, or cloud sync. The widget reads the app’s local cache and never contacts OpenAI itself.

Make room for
one small utility.

Releases

Before you install

macOS 15 or later and an existing local Codex sign-in. Satellites need a usable built-in MacBook notch; the widget also works on Macs without one, but the satellite Settings Bar is unavailable there.

  1. Use a signed and notarized DMG from GitHub Releases when a formal release is available.
  2. Drag CodexSatellites into Applications, then launch it.
  3. Add the widget from the macOS widget gallery if you want it.

Free and open source. MIT licensed.