Agent HUD 0.6.0-beta.4

Agent HUD 0.6.0-beta.4

Compatibility

Requires Agent HUD for iPhone 1.7.2 or later for iPhone and Apple Watch sync. Update the iPhone app before updating the Mac. Older iPhone versions cannot read this release's data.

Get the iPhone app.

If the required iPhone version is not yet on the App Store, cross-device features require the corresponding TestFlight version.

Requires macOS 14 or later. Download the arm64 DMG for an Apple Silicon Mac and the x86_64 DMG for an Intel Mac.

Changes

New

• Supports Antigravity more fully: its sessions and conversations, hooks, questions and approvals, new sessions, Remote control and agent messaging.
• Reads relays: add one by hand or let Agent HUD recognise it, then see its balance and prices with the key its client already uses. Each relay has its own settings page.
• Adds a price page where you can correct what a model costs.
• Records each call under the route it goes through, for Codex, Claude Code and Hermes; local routes cost nothing.
• Prices Haiku 5.5, Gemini 4 Argon and Antigravity's effort variants.
• Tags each session with where its first and latest prompts were typed, and shows them in the session's Statistics detail.
• Shows the last 24 hours for agents with no quota window or balance.
• Reads Cursor's sessions and tokens on this Mac, and Grok Bot's daily tokens per bot.
• Queues Codex messages through the command line inside Codex.app or ChatGPT.app, and opens another client's Codex thread in the Codex app.
• Lists each local-network iPhone's app version next to its name.
• Checks which of your devices run an older Agent HUD. A Mac that is behind looks for the update at once, and Settings → Subscription marks every device that is behind.

Fixes

• Lists sessions by their last message.
• Sends iPhone and Apple Watch messages to Claude Code as your own words, and records the HUD's answers as sent from the Mac.
• Keeps a client's settings file as it was when Agent HUD edits it, and no longer re-sorts ~/.claude.json.
• Says why Codex has no ChatGPT plan limits, and tells you to update Claude Code when it is too old for the plugin. Brings an installed Claude plugin up to date at launch.
• Shows what priced calls cost when some calls have no list price.
• Reads each log once for both its tokens and its conversation, looks at held logs every 3 seconds, and watches only the folders it reads.
• Streams local-network changes to the iPhone as they happen.
• Hides and orders panel rows by the keys layouts carry over.

Windows (test build)

• Agent-HUD-0.6.0-beta.4-windows-x86_64-unsigned-setup.exe is an unsigned test installer for Windows x64, built by GitHub Actions. It has not been tested on a real Windows machine yet.
• Windows may warn about an unknown publisher. The Windows build does not update itself: install the next version by hand.
• Agent HUD Remote (iCloud) is available on the Mac only.

Linux (test build)

• Agent-HUD-0.6.0-beta.4-linux-x86_64-unsigned.AppImage and Agent-HUD-0.6.0-beta.4-linux-amd64-unsigned.deb are unsigned test packages for x86_64 Linux, built by GitHub Actions on Ubuntu 22.04. They have not been tested on a real Linux desktop yet.
• Agent HUD needs gtk-layer-shell (libgtk-layer-shell0 on Debian and Ubuntu); the .deb installs it. On Wayland the edge HUD needs a compositor with wlr-layer-shell; GNOME does not offer it.
• Client hooks are not installed by the Linux packages yet, and the Linux build does not update itself: install the next version by hand.
• Agent HUD Remote (iCloud) is available on the Mac only.

Agent HUD 0.6.0-beta.3

Agent HUD 0.6.0-beta.3

Compatibility

Requires Agent HUD for iPhone 1.7.2 or later for iPhone and Apple Watch sync. Update the iPhone app before updating the Mac. Older iPhone versions cannot read this release's data.

Get the iPhone app.

If the required iPhone version is not yet on the App Store, cross-device features require the corresponding TestFlight version.

Requires an Apple Silicon Mac running macOS 14 or later.

Changes

Coming from 0.5.5

• Includes everything in 0.6.0-beta.1, which moves Agent HUD to a new cross-platform app and brings your settings and 30 days of quota history with it, and the fixes in 0.6.0-beta.2.

New

• Shows a progress bar while Agent HUD reads your agents' history for the first time, or again after an update that changes how it reads them. Tokens and costs are marked incomplete until it finishes.
• Shows the Mac's Tailscale address beside its local network address in Local network settings, and offers both to the iPhone.
• Tracks more than one Codex or Antigravity account, with a choice of how quotas are shown.
• Offers Claude Code a task with no project, as Codex has. Such tasks are kept in ~/.agenthud/sessions, as in the Swift app.
• Opens a session's page when you click its row in the HUD panel.
• Copies words selected in the HUD with ⌘C.

Fixes

• Shows each Claude Code message once on the iPhone, and what Claude writes while it works, not only its last reply.
• Compresses local network replies for an iPhone that asks for it, so readings arrive over slow links such as a Tailscale relay.
• Keeps Claude's last quota reading when Claude Code reports plan limits without numbers, and says why a detected agent has no reading, such as a Claude Code that needs signing in again.
• Says why a question card can't be answered on the Mac or the iPhone, and what would fix it.
• Carries more over from the Swift app: the Remote, local network and sharing switches with the pairing identity, the automatic update choices, and the quota history of Cursor, Antigravity and Grok Bot.
• Keeps iCloud on when the Swift app's usage ledger can't be imported.
• Reads only Claude Code sessions and their subagents as Claude logs, not workflow journals.
• Times each reply by its own call, so tool runs no longer pull the reply rate down; Copilot calls are timed by their own spans.
• Lets you quit from Settings, and lets Transparency clear the HUD's background fully.
• Names the running app in the Login Items approval notice.
• Removes the grey bands from the notch panel's shadow.

Windows (test build)

• Agent-HUD-0.6.0-beta.3-windows-x86_64-unsigned-setup.exe is an unsigned test installer for Windows x64, built by GitHub Actions. It has not been tested on a real Windows machine yet.
• Windows may warn about an unknown publisher. The Windows build does not update itself: install the next version by hand.
• Agent HUD Remote (iCloud) is available on the Mac only.

Agent HUD 0.6.0-beta.2

Agent HUD 0.6.0-beta.2

Compatibility

Requires Agent HUD for iPhone 1.7.2 or later for iPhone and Apple Watch sync. Update the iPhone app before updating the Mac. Older iPhone versions cannot read this release's data.

Get the iPhone app.

If the required iPhone version is not yet on the App Store, cross-device features require the corresponding TestFlight version.

Requires an Apple Silicon Mac running macOS 14 or later.

Changes

Coming from 0.5.5

• Includes everything in 0.6.0-beta.1, which moves Agent HUD to a new cross-platform app and brings your settings and 30 days of quota history with it.

Fixes

• Takes over what 0.5.5 published to iCloud the first time it starts, so those records still expire on time and go away when you turn Agent HUD Remote off. If you run 0.6.0-beta.1, this beta catches up.
• Shows again on the iPhone where each session runs, the CLI, the desktop app or an IDE, instead of only the agent's name, and lets you filter by it.
• Stops the iPhone from showing token and cost totals as complete while the Mac is still reading your agents' logs.
• Lets only one copy of Agent HUD collect into the same data at a time: a second copy, such as a build of agent-hud-open, is refused while the first one runs.

Agent HUD 0.6.0-beta.1

Agent HUD 0.6.0-beta.1

Compatibility

Requires Agent HUD for iPhone 1.7.2 or later for iPhone and Apple Watch sync. Update the iPhone app before updating the Mac. Older iPhone versions cannot read this release's data.

Get the iPhone app.

If the required iPhone version is not yet on the App Store, cross-device features require the corresponding TestFlight version.

Requires an Apple Silicon Mac running macOS 14 or later.

Changes

Rebuilt for every desktop

• Moves Agent HUD from the native Swift app to a new cross-platform app, built with Tauri 2. A Rust core reads your agents and works out tokens, quotas, prices and sessions once, the same way on every system; a new interface shows what it computes, and a thin native layer handles each system.
• Keeps what you use every day on the Mac: the Notch, Simple and Dynamic modes, the glow, quotas and balances, token statistics and sessions, approvals and questions on the HUD, the bots, the menu bar, and Agent HUD Remote for iPhone and Apple Watch.
• Brings your settings and the last 30 days of quota history over from 0.5.5 the first time it starts, then keeps its own. Token statistics are counted again from your agents' logs.
• Makes agent-hud-open the source of this app; it also builds on Windows and Linux, in preview. The native Swift app's source continues as agent-hud-native-open.
• Stays light: about 7% of one CPU core and 240 MB of memory while your agents are idle, measured on an Apple M1 Max.

Agents work together

• Lets a Claude Code or Codex session message another session, or start a new one, and read its reply through Agent HUD's MCP server. A message waits until the receiving session is idle and never interrupts a turn. Turn it on in Settings → Agents → Agent plugins.
• Shows every message as a paper plane that flies from the sender's mark to the receiver's, and the answer flies back the same way.
• Lets agents ask Agent HUD's MCP tools about your usage, sessions and statistics, as well as arrange the HUD.
• Adds Settings → Agents → Agent plugins, with one card per client for Agent HUD's Claude Code plugin and the MCP tools.
• Answers the questions and next-step box of the Claude desktop app on the HUD, in the session that asked, without Agent HUD Remote.

Sessions and statistics

• Redesigns sessions. Every row draws its last 64 turns, with sub-agents faded, compactions marked and the running turn outlined. A session's page shows its state and duration, a chart per turn, a context chart with compactions and the model's limit, and a sub-agents card that splits the session's own tokens from its sub-agents'.
• Places sub-agent sessions under the session that started them, and counts their tokens in it.
• Shows the tools each Claude Code or Codex call asked for, across the whole session.
• Steps through statistics charts with ← and →, and clears the selection with Esc.

Agents

• Adds Devin CLI: its sessions and tokens, quotas, approvals and replies.
• Shows Grok CLI and Grok Bot as two sources.
• Reads Claude Code logs under CLAUDE_CONFIG_DIR, and shows Claude's Haiku, Fable and Mythos weekly windows when your plan has them.
• Takes you back with one click to more sessions: Codex sessions run by its app-server, and Claude Code sessions started from the Claude desktop app.
• Picks up turns sooner: starts, ends and replies arrive as soon as an agent's hook fires, and a newly installed agent appears within seconds.
• Says on the HUD when an answer to the Codex desktop app fails, instead of leaving the card in place.
• Counts each Claude Code response's whole output, so totals from logs written before about September 2026 can read higher.

The app

• Updates itself from now on: it checks once a day, shows New Version… in the menu bar and an arrow in the HUD panel, verifies every update before it installs, and installs only when you choose. If you joined beta releases in 0.5.5, you stay on betas.
• Brings Settings forward when you open Agent HUD a second time, and shows the real state of Open at Login, including when macOS waits for your approval in Login Items.
• Keeps Mission Control's window previews intact while Simple mode runs.

In this beta

• The HUD has no glass material: every look is solid, with a transparency slider. The "Play a sound" option is gone.
• Not here yet from 0.5.5: the first-launch welcome, the quota forecast on hover, returning to an agent's latest session by clicking its logo in the panel, the panel's refresh-failure line, DeepSeek's low-balance colours, Grok CLI's quota, a GLM plan held only by WorkBuddy, Kimi plans without the Kimi CLI, Antigravity's quota for terminal-only agy, and the menu bar menu in the HUD's look.
• Tell us what else you notice in GitHub Issues.

Agent HUD 0.5.5

Agent HUD 0.5.5

Compatibility

Requires Agent HUD for iPhone 1.5 or later for iPhone and Apple Watch sync. Update the iPhone app before updating the Mac. Older iPhone versions cannot read this release's data.

Get the iPhone app.

Requires an Apple Silicon Mac running macOS 14 or later.

Changes

Quota names on every device

• Keeps quota window names and short forms in English, so an English iPhone, widget or Apple Watch no longer receives Chinese names from a Mac using Chinese. Names update after the Mac reads and syncs the account again.

Docks and appearance

• Keeps every logo visible on Simple and Dynamic docks while a reply or request opens beside the sending agent's logo.
• Gives each display its own dark, light or system appearance, solid or glass material and transparency. Settings → General can match windows to their display's HUD as an experimental option.
• Lets both dock sizes run from 20 to 60 pt, adds Simple panel logo spacing and uses one smaller text size for dock numbers, reminders and the hover line.
• Makes the agents' bots act out thinking, tools, approvals, questions, plans, compaction, failures and usage limits. Claude's bot is Clawd.
• Keeps the menu bar's figure, colours and agent order in step with the main display's HUD and its layout.

Arrange the HUD with an agent

• Adds client checkmarks and add/remove actions for the MCP server in Settings → Experimental.
• Names the tools get_hud, get_hud_screenshot, draft_hud, discard_hud_draft and finish_hud_edit. The server remains agent-hud; turn on the renamed HUD tools switch again to use it.
• Lets an agent filter sessions by project and period, choose block accounts and row order, change panel switches and propose app settings as a draft for you to save.
• Holds the panel open while an agent arranges it, then lets go when the edit finishes or you dismiss it.
• Adds balance burn rates, estimated run-out times and cost charts to API balance blocks.

Sessions and other agents

• Removes archived or deleted sessions from session lists while keeping their tokens in the usage totals until the ledger expires them.
• Lets a session using a tool take over an agent's mark from one that is thinking.
• Answers Claude Code plan approvals on the HUD, including accepting edits or returning feedback to keep planning.
• Ends Claude Code turns promptly when their logs report a usage limit or API failure.
• Keeps one provider order across Settings, the HUD, glow, menu bar and token statistics.
• Shows WorkBuddy's model ceilings and credits, reads a GLM plan held only by WorkBuddy under that group and handles a CodeBuddy CLI using WorkBuddy's configuration as WorkBuddy.
• Reduces artwork memory, repeated island layout and process inspection for clients that are not installed.

iPhone and Apple Watch sync

• Sends Claude's narrations and questions to the phone, including questions answered through the Claude desktop app's next-step box.
• Keeps published turn text once and improves local-network change tracking and conversation-cache recovery.
• Ships the Mac executable stripped and the updater for Apple Silicon only, while keeping debugging symbols locally for crash reports.