Agent HUD

Your agents, at a glance.
Usage, tokens and sessions for Claude Code, Codex and 15 more agents, at your Mac's notch or any screen edge.

English · 简体中文 · Website · Supported agents · Documentation

Agent HUD keeps your coding agents in view while you work in another app.

• How much quota is left? The glow turns green, yellow or red as a quota fills. Hover for the numbers.
• Which agent is waiting for you? Approvals, questions and replies in one place, and a click takes you back.
• Where did the tokens go? Statistics by time, agent, model, session and turn, with the cost at API prices.
• Away from your Mac? The same numbers on your iPhone and Apple Watch.

At a glance, or a hover

_{Simple mode on a display's left edge, with Separate agents on · Sample data}

A glance. The glow shows one colour per quota, such as a 5-hour or weekly limit: green under 70% used, yellow from 70%, red from 90%. In Simple mode the ring around each logo does the same. The glow moves faster while an agent is working.

A hover. The panel opens with the numbers:

• Quotas: each one's share used and reset countdown, or its burn rate.
• Balances: account and prepaid balances, where an agent has them.
• Tokens: the last 24 hours in 15-minute bars.
• Sessions: up to five, those waiting for you first.

At the notch, and on every display

• A MacBook with a notch: Agent HUD lives at the notch.
• A display without one: it gets a HUD of its own, a row of agent logos you can drag to any screen edge.
• Every display keeps its own mode, position, size and glow.
• Requests and reminders show on one display only: the one your pointer is on.

Approvals, questions and replies in one place

When an agent needs you, its request waits on the HUD with the command, file, edit diff or tool input it is asking about. Answer there, without switching windows.

• Approvals: Deny, Allow once, or Always allow where the agent offers a rule.
• Questions: pick an option, or type your own.
• Replies: a New reply reminder when a turn finishes.
• One click back: a session's title, or Return to session, takes you to its thread, tab or iTerm2 pane.

Where the tokens go

The statistics window keeps 30 days of token history on your Mac.

_{The Tokens page and a session's page of the statistics window · Sample data}

• By time: the last 5 hours, 24 hours, 7 days or 30 days, in bars as fine as 15 minutes.
• By agent and model: one card per agent, and a chart you can narrow to any models and token kinds.
• By session, turn and call: tokens per turn, how full the context window got, and every model call in a turn.
• Sub-agents and cache: sub-agent tokens inside their parent session; cache hit rates per period, session and model.
• What it is worth: priced at the vendor's API prices where a model has one, and marked ≈. On a subscription it is an estimate, not a charge.

On your iPhone

Agent HUD for iPhone and Apple Watch shows what your Mac collects: quotas, balances, token statistics and sessions, in the app, in widgets and on the Watch. The app is free.

_{Agent HUD for iPhone · Home and Sessions · Sample data}

On the same network, viewing is free. In the official Mac app, turn on Settings → Local network → Share this Mac. An iPhone on the same Apple Account connects by itself; any other iPhone pairs by scanning a QR code. The Mac serves the phone directly, with no Agent HUD server.

Agent HUD Remote

The one paid feature, for when you are away from your Mac. It syncs through your own iCloud and adds:

• Any network: your Macs on iPhone, in widgets and on Apple Watch.
• Conversations: the prompts and replies of Claude Code, Codex, Grok CLI, Grok Bot and Antigravity sessions, to read on the phone.
• Remote Sessions (experimental; turn it on in the Mac's Settings → Experimental): allow or deny a tool call, and message Claude Code and Codex sessions, from the phone. See the guide.
• Alerts and Live Activities: alerts on iPhone and Apple Watch, and your running sessions on the Lock Screen and in the Dynamic Island.

Bots, modes and settings

Bots. Every agent's logo has a small bot in the logo's own shape and colours, with eyes that follow your pointer. It hops when the agent needs your approval and smiles when a turn is done. See every agent's bot.

Modes. Each display runs one of three: Notch by default where there is a notch, Dynamic elsewhere.

| Mode | On screen | | --- | --- | | Notch | At the notch, with the glow around it. | | Simple | A small floating panel on any screen edge: each agent's logo in a ring of its most used quota, with the percentage beside it. | | Dynamic | A row of agent logos on any screen edge, with the glow behind them. A logo becomes its bot while its agent works. |

Settings. Choose the accounts and quotas to show, each display's mode, size and glow, and what the panel contains. The app runs in English or Simplified Chinese. ⌘⌥H hides or shows the glow.

Supported agents

Install and sign in to the agents you want to monitor; Agent HUD finds them by itself. All 17 report tokens and sessions.

| Agent | Quota | Live status | Approvals | Questions | Replies | One click back | Turns and calls | | --- | :---: | :---: | :---: | :---: | :---: | :---: | :---: | | Claude Code | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | Codex | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | | DeepSeek Harness | Balance | ✓ | | ✓ | ✓ | | ✓ | | Antigravity | ✓ | | ✓ | | ✓ | ✓ | | | Cursor | ✓ | | | | ✓ | | | | Grok CLI | ✓ | ✓ | | | ✓ | ✓ | | | Grok Bot | ✓ | | | | | ✓ | | | GitHub Copilot CLI | ✓ | ✓ | | | ✓ | | | | OpenCode | ✓ | | | | ✓ | ✓ | | | Kimi | ✓ | ✓ | | | ✓ | | | | Pi | ✓ | ✓ | | | ✓ | ✓ | | | OpenClaw | | ✓ | | | ✓ | | | | Hermes Agent | | | | | | | | | ZCode | | | ✓ | ✓ | | | | | CodeBuddy | | | ✓ | | ✓ | | | | WorkBuddy | | | ✓ | | | | | | Qwen Code | | | ✓ | | ✓ | | |

Also: the GLM Coding Plan quota, and approvals for the Qoder builds. Codex approvals need its hook trusted in Codex, and Copilot's quota your consent in Settings. The rest is in each agent's details.

Your data

• Read on your Mac: the records your agents already keep. Usage history stays in a local database.
• Read from each vendor: quotas, balances and Cursor's usage, with the agent's existing sign-in or configured key. No read sends a message to a model, and credentials are never stored.
• Written on your Mac: hooks in your agents' own settings, to receive requests and replies. Client hooks in Settings → General removes them all.
• Uploaded: nothing, by a build from this source. What the official app shares with your iPhone, through your iCloud and for Live Activities is in its privacy policy.

Build from source

Requirements: macOS 14+ and Xcode or the Xcode Command Line Tools with a Swift 6 toolchain.

git clone https://github.com/jazzenchen/agent-hud-open.git
cd agent-hud-open
make check
make test
make run

This builds and opens build/Agent HUD Open.app, signed ad-hoc for local use. No developer account, signing identity or provisioning profile is required. To try the app without any agents, quit it and run make demo, which opens it on sample data.

Documentation

HUD and approvals · Providers · Usage semantics · Session lifecycle · Session navigation · Data access · Architecture · Performance · Command line · Updates · Brand assets · Changelog

License

Apache-2.0. Provider references and icon assets retain their third-party notices and icon license.

Star History