agent-hud-open
A HUD for Claude Code, Codex and 25 more coding agents. Know your quotas, tokens and sessions at a glance, answer requests and jump back in one click. On Mac, W
What is agent-hud-open?
A HUD for Claude Code, Codex and 25 more coding agents. Know your quotas, tokens and sessions at a glance, answer requests and jump back in one click. On Mac, Windows and Linux, your phone and your watch.
Overview of agent-hud-open
What it is
Agent HUD is a HUD for Claude Code, Codex and 25 more coding agents. It displays quotas, tokens and sessions at a glance, allows answering requests and jumping back to sessions. It runs on Mac, Windows and Linux, and has companion apps for iPhone and Apple Watch.
Key features
- Glow: one colour per agent from its most used 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: shows quotas with their resets or burn rates, balances, the last 24 hours of tokens, and sessions waiting for you first.
- Requests: approve, deny or always allow, and answer an agent's questions on the HUD. Unanswered requests return to the agent after 10 minutes.
- Jump back: one click takes you to a session's thread, tab or terminal pane.
- Two display modes: Notch (at the notch with glow around it) and Simple (a small floating panel on any screen edge with each agent's logo in a ring of its most used quota and the percentage beside it).
- Phone and watch remote: iPhone app shows progress, replies and allows continuing conversation; Apple Watch app allows starting a session by voice and reading the latest reply.
- Built-in MCP: agents can message each other (Claude Code, Codex, Antigravity, DeepSeek Harness) and you can tell an agent to rearrange the HUD layout.
- Token usage tracking: track tokens by time (today, last 7, 30, 90 days, year), token kinds (input, output, reasoning, cache writes, cache reads), agents and models, sessions, turns and calls, cache hits, cost estimate at vendor list price, plans, activity heatmap, quotas, balances.
Use cases
Monitor multiple coding agents from a single HUD while working on other tasks. Approve agent requests and answer questions without switching context. Track token usage and quotas across agents and models. Start and continue agent sessions from a phone or watch. Let agents communicate with each other via MCP.
Getting started
Install on Mac with Homebrew:
brew install --cask jazzenchen/tap/agent-hud
Install on Mac, Windows or Linux with Node.js:
npx @agenthud/install
Or download the release. On Mac, Agent HUD updates itself. If already in /Applications, add --adopt to the Homebrew command.
License and pricing
License: Apache-2.0. Pricing: open source (free).
Based on the project's public README and repository metadata.