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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/jazzenchenagent-hud-open.svg)](https://yunodb.com/tools/jazzenchenagent-hud-open?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/jazzenchenagent-hud-open?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/jazzenchenagent-hud-open.svg" alt="Featured on YunoDB" height="20"></a>