Agent HUD

HUD for your agents.
On your screen. On your phone. On your wrist.

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

Your agents work on your Mac. Agent HUD brings their progress to you. Check where they are at a glance, pick up a conversation, make the next decision: at your desk, and after you leave it.

Your agents, at a glance. You write code, read docs or deal with something else while your agents keep working. The edge of your screen tells you who is still busy, who is done and who is waiting for you.

The details are close at hand, and what needs your approval is answered right there. Every agent's progress, gathered where one glance takes it in.

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

• Glow: one colour per quota, green under 70% used, yellow from 70%, red from 90%, with a warning before a quota runs out. It moves faster while an agent works.
• Hover: quotas with their resets or burn rates, balances, the last 24 hours of tokens, and the sessions, those waiting for you first.
• Requests: approve, deny or always allow, and answer an agent's questions, all on the HUD, the questions Claude asks in its desktop app included. Agent HUD never decides for you: a request you leave goes back to the agent after 10 minutes.
• Jump back: one click takes you to a session's thread, tab or terminal pane.

Three modes. Each display runs one: Notch by default where there is a notch, Dynamic elsewhere.

Keep moving when decisions are needed. Leave your computer and the work still goes with you. On iPhone, check progress, read replies and continue the conversation.

When an agent reaches something only you can decide, your phone shows you the context, and you answer the question or approve the next step. The task keeps going, and so does your day. iPhone Duo is supported.

_{Agent HUD for iPhone · Home and Sessions, and Stats on an unfolded iPhone Duo · Sample data}

See Agent HUD Remote.

Start from your wrist, continue on iPhone. An idea comes to you on a walk. Raise your wrist, say it, and it goes straight to the Mac at home. A thought caught in passing becomes a task in progress.

Read the latest reply on your watch. To discuss it or add detail, continue on iPhone. The idea starts on your wrist, and the conversation goes where you go.

_{A note spoken to Apple Watch becomes a Codex session on the Mac · Sample data}

See Agent HUD Remote.

Your agents use Agent HUD too. Its built-in MCP server gives them a channel to talk to each other, and the tools to build the UI you want.

When Claude Code finishes a change, it can ask a Codex session to review it and get Codex's answer back, or start a new session and hand the task over. Agent HUD already sees every session, so it carries messages across clients.

You can watch who is talking to whom: the sender folds its message into a paper plane and flies it to the receiver's mark, and the answer flies back the same way.

• A message, not the conversation: only what the agent writes goes across; its session stays where it is. On one project, the project itself becomes the shared context, and the other agent reads the code for itself.
• Claude Code, Codex, Antigravity and DeepSeek Harness: each can message the others, or start a new Claude Code, Codex or Antigravity session.
• Never in the way: a message waits until its session is idle; it never interrupts a turn.
• In the release.

Tell an agent how you want to see things: “Put Codex first and keep only the numbers I care about.”

Through MCP, the agent rearranges your Mac HUD and changes what it shows and how it looks. The change appears at once as a preview and is kept only when you press Save, so the HUD fits the way you work.

• For Claude Code, Codex and any other MCP client.
• An agent can read the HUD, propose a layout or a look for any display, and check the result with a screenshot in which accounts are masked.
• The same tools answer questions about your usage, sessions and statistics, from the data the app already holds.

Know what your agents did, and how much they used. See your token use, look back at how it changed, and find where it went: which agents, models and sessions.

Quotas tell you how much is left. Token usage shows you how it was spent.

Familiar agent logos become small bots that act out thinking, working and waiting. With a face on every state, one glance tells you what is going on.

They give the HUD a character of its own: your agents busy at work, signalling when they need you. Each bot keeps its logo's shape and colours and follows your pointer with its eyes; Claude Code's is Clawd. See each bot's four states.

A HUD runs all day, so staying light is part of the experience. Agent HUD keeps its CPU, memory and energy use down, and leaves your system to your agents and the work in front of you.

Measured on a real Mac, not claimed:

Idle: no agent working, one display. Busy: agents writing to their logs, one or two displays. Release builds on an Apple M1 Max, macOS 26, with about 8,000 session logs. How it is measured.

Agent HUD is built with Tauri 2: a Rust core, a React interface, and a thin native layer for each operating system.

• One core. Reading your agents' records, counting tokens and working out quotas, prices and sessions happen once, in Rust, the same way on every system. The windows only display what the core computes.
• Each system in its own files. Paths, processes, credentials, hooks and windows are written once per system, so work on Windows or Linux never touches shared code.
• macOS today; Windows and Linux in preview. Both build from this source, but neither has been verified on real machines yet; what is still missing is under Coming soon.
• iPhone and Apple Watch pair with a Mac. Agent HUD Remote syncs through iCloud, so it is available on macOS only.

Your agents, wherever you are. Through your own iCloud, Agent HUD Remote keeps your iPhone and Apple Watch connected to the release on any network.

When your iPhone and the release share a network, iPhone and Apple Watch show your Mac's quotas, token statistics and sessions without a subscription. Remote adds:

• Any network: your quotas, token statistics and sessions, away from home too.
• Conversations: read Claude Code, Codex, Grok CLI, Grok Bot and Antigravity sessions, and message Claude Code and Codex.
• Decisions: allow or deny a tool call, answer a question, approve a plan.
• Your wrist: an idea you say becomes a new session on your Mac, and the reply comes back to your watch.
• Alerts and Live Activities: alerts on iPhone and Apple Watch, and your running sessions on the Lock Screen and in the Dynamic Island.

_{✓ Free to use · ★ Needs a subscription}

Check out in the App Store, inside the iPhone app: China mainland · International

• Windows and Linux out of preview, with client hooks on Windows, and Linux packages that can install them. Contributions are welcome.
• More agents, beyond the 18 in the table below.
• API keys billed by the token: their usage, spend and balance, next to your plans' quotas.
• UI prompt templates. Ready-made prompts that reshape your HUD in one go.
• A Gantt view of sub-agents. On a session's page, each sub-agent of a turn in its own lane on one time axis: when it started, how long it ran, what it used, and what ran side by side.
• Agents shape every screen, not only the HUD, with image backgrounds and a customizable iPhone app.
• More agents in the conversation, beyond Claude Code and Codex.
• Files both ways. Your agents send files to your iPhone, and you send files from your iPhone to your agents.
• Recordings straight to your agents. A recording from your Apple Watch or iPhone reaches your agent as it is.
• More of the HUD is your call: what Simple mode's rings show (burn rate, time to reset or cost), and which agents may alert you.
• More from each agent: Grok CLI's quota and one click back, OpenClaw's live status and replies, Devin's live status.
• Requests and replies on the HUD in builds from source, once client hooks leave the preview.
• HarmonyOS. An app for HarmonyOS phones is in review: on the same network as the release, your quotas, token statistics and sessions, with service cards on the home screen.

…and more.

Install and sign in to the agents you want to follow; Agent HUD finds them by itself.

Also: the GLM Coding Plan quota, and approvals for the Qoder builds. Codex approvals need its hook trusted in Codex, DeepSeek Harness approvals and questions need Agent HUD's plugin (Settings → Agent plugins), Copilot's quota needs your consent in Settings, and Devin's quotas come from its CLI's local cache. Cursor's tokens come from Cursor 3.27 or later. Grok Bot's bots run on Cursor's servers, which report each bot's daily tokens; an account merged into SuperGrok reports none, so only its sessions show. Grok Bot's weekly quota comes from the same servers when Cursor is signed in to the Bot's account, otherwise from the Bot's own cache, which it refreshes only while in use. An account merged into SuperGrok has one weekly limit for Cursor and Grok Bot, and Cursor's block shows it as Cursor does.

• Read on your computer: the records your agents already keep. Usage history stays in a local SQLite database.
• Read from each vendor: quotas, balances and Grok Bot's daily tokens, 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 computer: hooks in your agents' own settings, to receive requests and replies, only while client hooks are on. Turning them off removes them.
• Uploaded: nothing, by a build from this source.
• Access your data from iPhone and Apple Watch, through the release:
  • On the same network, over HTTPS, with the Mac's certificate pinned when the phone pairs.
  • Anywhere, with Agent HUD Remote, through your own iCloud. Record contents are end-to-end encrypted with keys in your iCloud Keychain; only the text an alert shows stays outside that encryption, so iOS can display it.
  • Live Activities of running sessions, also with Remote, pass through Agent HUD's relay to Apple's push service. The relay keeps only what forwarding needs, each Mac's latest sessions and each phone's card, with no account identity, and deletes an account it hasn't heard from in 30 days.

Requirements: Node.js 24+, pnpm, a current Rust toolchain (1.90+), and Tauri's prerequisites for your system.

git clone https://github.com/jazzenchen/agent-hud-open.git
cd agent-hud-open
pnpm install
pnpm run check
pnpm run build:macos -- --bundle

Use build:windows or build:linux on those systems; each command builds only for the system it runs on. Tauri writes the app under target/release/bundle. To try the app without any agents, start it with --demo, which opens it on sample data.

A patched Tao. On macOS the HUD has to be a panel that never takes focus from the app you are using, and upstream Tao cannot create one yet (tao#414). Until it can, the workspace takes tao from a public fork with one small commit on top of 0.37.1, pinned by revision in Cargo.toml; Cargo fetches it from GitHub on the first build. What the commit changes, and how to move it to a new Tao release: Tao patch.

Preview. This build is checked against the native Swift app, agent-hud-native-open (formerly agent-hud-open), behavior by behavior, in the parity ledger. It does not install client hooks yet, so approvals, questions and most replies stay in each agent's own prompt.

Development · Platform architecture · Platform builds · Accounts · Client hooks · Session data · Performance · Parity ledger · Tao patch · Third-party sources · Contributing

Apache-2.0. Interface components, provider artwork and Clawd's sprites keep their own notices; see third-party sources.