Skip to content
IconSwapper

See Claude usage in your Dock

Show your Claude allowance as a fill level, add a percentage, and choose when the labels appear.

See Claude usage in your Dock — IconSwapper artwork
Illustration using IconSwapper artwork

Connect Claude

You’ll need the Claude desktop app, a signed-in Claude account, and IconSwapper on macOS 14 or later.

  1. Open Claude and check that you’re signed in to the account you want to follow.
  2. In IconSwapper, choose Add App → Live Icon → Claude.
  3. Check the account shown in IconSwapper. If it asks for Keychain access, choose Allow access… and follow the prompt so it can read your signed-in account’s usage.
  4. Open Usage and choose Used or Remaining. Choose Color fill or Water for the meter.

Used rises as you spend your allowance. Remaining falls. Keep IconSwapper running and check Claude’s actual Dock icon.

The shared Usage controls offer Color fill and Water. Cursor is shown here; Claude uses these same meter controls.
The shared Usage controls offer Color fill and Water. Cursor is shown here; Claude uses these same meter controls. Click to enlarge.

Add a percentage

Open Percentage → Show. Choose Always for a permanent number, or On hover to reveal it when you need it.

For a quieter Dock, choose When usage reaches… and set the threshold to 80% used. The number appears when you reach that point, or when you hover over the icon. The threshold always means usage spent, even if the label shows what remains.

Use Percentage → Show to choose when the number appears. These label controls are shared by the AI Live Icons.
Use Percentage → Show to choose when the number appears. These label controls are shared by the AI Live Icons. Click to enlarge.

Show the reset countdown

Open Reset countdown → Show and choose when the label should appear. Use When reset is within… to show it only near the reset, or Always to keep it visible.

Percentage and reset labels have separate rules. Hover and Command-Tab interaction need Accessibility access. The editor keeps configured labels visible so you can style them; check the Dock to see the visibility rules in action.

If the reading looks wrong

Check the account and usage status in IconSwapper, then use the refresh button beside the account heading. If you’re signed out, sign in through Claude first.

Turn off Try an example percentage if you enabled it in the editor. An example is for styling, not a live reading. Usage and thinking are separate: an animated icon means the assistant is working, not that it has reached a particular usage level.

Remove the meter

Choose Usage → None to hide the usage fill. Choose Restore Original Icon to return to Claude’s original artwork.

By Michael Flarup