valerijaspasojevic

Agent Fleet Hud — AI skill for Claude Code

AI community

A notch-resident HUD for the AI coding agents already running on your Mac — Claude Code, Codex and Cursor: which is working, which needs an answer, which is rate-limited and when it resets.

How to install Agent Fleet Hud

This entry records only its repository, not the path inside it, so there is no exact command to give. Open valerijaspasojevic/agent-fleet-hud and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agent Fleet Hud does

A notch-resident HUD for the AI coding agents already running on your Mac — Claude Code, Codex and Cursor: which is working, which needs an answer, which is rate-limited and when it resets. A monitor, not an agent framework.

Alternatives in AI

MioIsland — macOS Dynamic Island for AI coding agents 388 ★
Gentle Agent State — See which AI coding agent needs you — right in your tmux tab bar 54 ★
Coding Agent Usage Tracker — Single CLI to monitor LLM provider usage across Codex, Claude, Gemini, Cursor, and Copilot: remaining quota, r 48 ★

README

Agent Fleet HUD

A notch-resident HUD for the AI coding agents **already running** on your Mac.

It does not run, spawn or orchestrate agents. You start them however you normally do — `claude`, `codex`, Cursor — and this watches them: which is working, which is waiting on an answer, which is out of usage window and when it comes back. You can message one without leaving what you are doing.

![The panel, showing sample agents](docs/screenshot.png)

*Rendered from the real panel with sample agents — `./make-screenshot.sh`.*

Collapsed, it's a small black tab hanging under the notch with live counts: red = blocked by the usage limit, blue = needs your input, green = working, amber = idle and waiting on you, slate = up but we cannot tell. It appears only while something is running and hides itself completely when nothing is.

Hover it to slide open the panel. Click the tab to pin it open (pinning also gives it keyboard focus so you can type a message).

What it detects

Nothing is hardcoded to one machine: apps are located by bundle identifier rather than assumed to be in `/Applications`, the build targets whatever architecture you build on, and every path is derived from your home directory.

Source	How	Busy/idle	Send a message	Stop
Claude Code	`~/.claude/sessions/*.json`	yes, real status	yes, exact session	yes
Cursor	`cursor-agent` worker processes	no — see below	yes, newest chat in the workspace	yes
Codex	the `codex` process — ChatGPT.app's `app-server` or the standalone CLI	no — see below	yes, most recent thread	yes

Messaging

Nothing here takes your focus. The message goes on the clipboard and the paste and return keys are posted straight to the target process with `CGEventPostToPid`, so the app never comes to the front — you keep working where you are while the message lands.

That needs Accessibility permission, because synthesising key events is what macOS gates. It does *not* need Au