CodexSatellites

Made for macOS

Keep your quota
in sight.

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

Download v0.4.0Try 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, available reset count, and CodexSatellites running status on your desktop or in Notification Center. Choose Small for a glance, Medium for reset times too.

Click the widget content to re-read the app’s local cache and check whether CodexSatellites is running now; that action never contacts OpenAI or starts the app. macOS Edit Widget provides Launch at Login and 1 / 5 / 15 minute frequency controls, including on Macs without usable notch satellites.

Dark desktop surface behind the widget layout illustrations
Small CodexSatellites widget with two circular quota gauges, reset count, and running status Medium CodexSatellites widget with two circular quota gauges, reset times, reset count, and running status
Small + Medium · Representative values · Native layout proportions

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.

Download v0.4.0

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, with Launch at Login and Frequency available through macOS Edit Widget.

  1. Download the v0.4.0 DMG from GitHub Releases.
  2. Drag CodexSatellites into Applications.
  3. Launch it. Because v0.4.0 is not notarized, macOS may require you to explicitly approve the app on first open.
  4. Add the widget from the macOS widget gallery if you want it.

Free and open source. MIT licensed.