Skip to content
IconSwapper

See ChatGPT and Codex usage in your Dock

Show the allowance reported by your local Codex sign-in on the ChatGPT Live Icon.

See ChatGPT and Codex usage in your Dock — IconSwapper artwork
Illustration using IconSwapper artwork

Connect the account

You’ll need IconSwapper on macOS 14 or later and a local Codex sign-in with your ChatGPT account. Signing in only on the ChatGPT website does not supply this reading.

  1. Open Codex and sign in with the ChatGPT account you want to follow.
  2. In IconSwapper, choose Add App → Live Icon → ChatGPT.
  3. Check the account and usage rows shown in IconSwapper. Follow any setup or permission guidance.
  4. Under Usage, choose Used or Remaining, then Color fill or Water.

Keep IconSwapper running. Check the ChatGPT icon in your Dock rather than relying on the editor preview.

Choose a fill style in Usage. The same meter controls are shown here on Cursor.
Choose a fill style in Usage. The same meter controls are shown here on Cursor. Click to enlarge.

Understand the reading

The meter uses the usage information returned for the locally signed-in Codex account. It is not a count of every ChatGPT message, API token or API charge. Read the named limits in the account panel to understand what the service is reporting.

If you use different accounts in ChatGPT and Codex, check the account shown in IconSwapper before interpreting the meter.

Choose the labels

Under Percentage → Show, choose Always, On hover or a usage threshold. Under Reset countdown → Show, choose when the reset label should appear. The two labels have independent rules.

A threshold always means percentage used, even when you display remaining allowance.

Open Percentage → Show to choose a visibility rule. The AI Live Icons share these controls.
Open Percentage → Show to choose a visibility rule. The AI Live Icons share these controls. Click to enlarge.

If usage is unavailable

Check the account status and refresh button in IconSwapper. Sign in through Codex again if the account is signed out. An API-key-only setup does not provide the account sign-in this reader expects.

Turn off Try an example percentage if enabled. Do not mistake a preview number for a live reading.

Remove the usage display

Choose Usage → None to hide the fill, or Restore Original Icon to restore the original artwork.

By Michael Flarup