Agent HUD

Agent HUD

Your agents, at a glance. Usage, tokens and sessions for Claude Code, Codex and 16 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.

A warning before a quota runs out. It comes at 90% used, or sooner if the quota will not last until its reset.

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](#bots-modes-and-settings), 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.

Agent HUD never answers for you: a request you leave alone goes back to the agent's own prompt after 10 minutes. [Which agent supports what](#supported-agents).

Where the tokens go

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