Agent HUD · Guides

Checking your agent usage on iPhone and Apple Watch Coming soon

Quota runs out while you are away from the desk as easily as while you are at it. This is what your Mac can show you somewhere else.

On the phone

Usage from your Macs on one screen: quota, available resets and DeepSeek balances together, with token use over time split into input, output and cache reads.

The numbers you care about most can be pinned as widgets — a session and weekly bar for Claude, a weekly bar with remaining resets for Codex, a balance and daily cost for DeepSeek — including on the Lock Screen.

While a turn is running

  • Running sessions stay visible on the Always-On display.
  • You can see your Mac's sessions and how long they have been going without unlocking.
  • The running count sits in the Dynamic Island; expanding it shows session titles and live timers.
  • A finished turn shows a checkmark and its final duration.

On the wrist

  • Claude — session and weekly quota, each in its own ring.
  • Codex — weekly quota, reset times and how many resets are left.
  • DeepSeek — your balance, plus the estimated cost for the last 24 hours.
  • Tokens — recent usage by model.
  • Sessions — your recent sessions and what they spent.

How it travels

One Mac's usage reaches your devices through your own iCloud account. There is no Agent HUD account to make, and nothing passes through a server of ours on the way.

Macs never sync with each other: each one publishes its own usage, and your phone is where they appear together.

What travels is usage, activity and session summaries — not your conversations and not your AI account credentials. A session title can carry text from your task, and that is what would appear on a Lock Screen, so it is worth knowing before you turn it on.

What you can have today

Everything on your Mac — agent activity, quota, resets, token usage, turn-complete and low-quota alerts — is free and working now.

Reaching your other devices is Agent HUD Remote, and it is not open yet. The waitlist is how you hear when it is: it takes an email, optionally a name, and which features you would actually use.

Join the waitlist

Common questions

Do I need an Agent HUD account?
No. Your usage moves through your own iCloud account, so there is no account to create and no server of ours in between.
Do the iPhone and Apple Watch apps cost anything?
They are free and carry no in-app purchases. What they show comes from a Mac with syncing turned on.
Do my Macs sync with each other?
No. Each Mac publishes its own usage to your devices; none of them reads another's.
Does my code or conversation leave the Mac?
No. Usage, activity and session summaries travel; conversations and AI account credentials do not. A session title can contain text from your task, and that title is what appears on your Lock Screen or watch.
When can I use this?
It is not open yet. Joining the waitlist is what tells you when it is.

Guides

Free on Mac

  • Agent activity and turn progress
  • Quota, resets and token usage
  • Turn completion, quota warnings and reset reminders

Get for free

Last updated: 2026-09-20 · The behaviour described here is documented in full, with the code it comes from, in Agent HUD Open. github.com/jazzenchen/agent-hud-open