Repolode
Submit
jazzenchen

jazzenchen/agent-hud-open

A macOS HUD that shows quotas, token usage and sessions for Claude Code, Codex and 16 other coding agents, with approvals and one-click return to sessions.

View on GitHubWebsite
Stars
124
Forks
24
Open issues
4
Last commit
17 hours ago

What is it?

Agent HUD is a heads-up display for AI coding agents. It sits at the edge of a Mac screen, at the notch, or as a floating panel, and shows each agent's quotas, balances, token usage and active sessions in one place. A colored glow reflects how much of the most-used quota is consumed, so you can see at a glance which agents are busy, finished or waiting.

From the HUD you can approve, deny or answer an agent's requests and questions, and jump back to a session's thread, tab or terminal pane with one click. Token usage can be broken down by agent, model, session and token kind over periods from 5 hours to 30 days, with history kept locally in SQLite. Costs are shown as estimates at list prices.

The Rust core is built with Tauri 2 and a React interface. macOS is the supported platform today; Windows and Linux builds are in preview. A companion iPhone and Apple Watch app, Agent HUD Remote, syncs through iCloud. The project is Apache-2.0 licensed.

Key features

  • 01Shows quotas, balances and token usage for Claude Code, Codex and many other agents
  • 02Colored edge glow flags agents that are busy, done, or running low on quota
  • 03Approve, deny or answer agent tool requests and questions from the HUD
  • 04One-click jump back to a session's thread, tab or terminal pane
  • 05Token breakdown by agent, model, session and token kind, stored locally
  • 06Built-in MCP server lets agents adjust the HUD layout and query usage data

Use cases

  • Keeping track of several coding agents running in parallel on a Mac
  • Watching quota burn rates to avoid hitting limits mid-task
  • Reviewing which models and sessions consumed the most tokens and cost
  • Approving agent actions from a phone or watch while away from the desk

Quick start

  1. 1

    Install with Homebrew on a Mac

    brew install --cask jazzenchen/tap/agent-hud
  2. 2

    Or install with Node.js on a Mac, Windows or Linux

    npx @agenthud/install

Things to know

  • The full app runs on macOS 12 or later; Windows and Linux are in preview and not yet verified on real machines.
  • iPhone and Apple Watch support through Agent HUD Remote works only with a Mac and iCloud.

In collections

Claude Code tools, skills & pluginsOpen-source AI agent frameworks & appsAI coding assistants & agentsOpen-source Mac apps

Topics

#ai-agents#coding-agents#claude-code#codex#token-usage#macos#tauri#rust#cursor#deepseek

FAQ

What is agent-hud-open?
A macOS HUD that shows quotas, token usage and sessions for Claude Code, Codex and 16 other coding agents, with approvals and one-click return to sessions. Agent HUD is a heads-up display for AI coding agents. It sits at the edge of a Mac screen, at the notch, or as a floating panel, and shows each agent's quotas, balances, token usage and active sessions in one place. A colored glow reflects how much of the most-used quota is consumed, so you can see at a glance which agents are busy, finished or waiting.
Is agent-hud-open free to use? What license does it have?
agent-hud-open is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is agent-hud-open still maintained?
Actively maintained. The last commit to agent-hud-open was on Nov 6, 2026.
What can I use agent-hud-open for?
Keeping track of several coding agents running in parallel on a Mac Watching quota burn rates to avoid hitting limits mid-task Reviewing which models and sessions consumed the most tokens and cost Approving agent actions from a phone or watch while away from the desk
How do I install agent-hud-open?
Install with Homebrew on a Mac: brew install --cask jazzenchen/tap/agent-hud Or install with Node.js on a Mac, Windows or Linux: npx @agenthud/install
Where can I get agent-hud-open?
The source code and installation instructions are on GitHub: https://github.com/jazzenchen/agent-hud-open

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects