/ 한국어 GitHub ↗

Agent HUD

Manage skills and plugins
for each project.
ON/OFF switches update Claude Code settings.

The dashboard runs on your computer without an account.

brew install --cask ganggangstone/tap/agent-hud-app or tell your AI agent: Install Agent HUD from github.com/ganggangstone/agent-hud

macOS only, for now

Then open Agent HUD from Launchpad. The dashboard opens in your browser at 127.0.0.1:41717.

Example: applying the app group reduces the project’s loaded skill count from 60 to 6

A coding agent loads available skills' names and descriptions at the start of a session.
Loading descriptions of unused skills wastes input tokens.

For example, an app development session can also load writing skills it does not use.

60 skills · 18,938 characters · estimated 5,000–9,000 tokens

60 installed 6 this project needs example

A project may use 6 skills but load 60.
Unused skill descriptions are included in the session context.

On the developer’s machine, the names and descriptions of 60 skills totaled 18,938 characters. The 5,000–9,000 token range is an estimate from that character count; actual token counts depend on the tokenizer. The dashboard shows how many skills the selected project loads.

Save skills and plugins as a group, then apply it to a project.

modes.json dev · video ~/work/app/ applied here .claude/settings.local.json enabledPlugins: dev .claude/skills/ → 3 links .agents/skills/ → 3 links ~/work/video/ unchanged .claude/settings.local.json enabledPlugins: video .claude/skills/ → 2 links .agents/skills/ → 2 links

A plugin bundles skills, commands and hooks. A group lists the plugins and skills you use together. Applying a group links its skills into the selected project and disables other plugins and skills outside plugins in Claude Code. These settings are saved in the project folder. Plugin changes take effect from the next session.

Link the same skill folder to several agents.

diagnosing-bugs/ SKILL.md same folder .claude/skills/ .agents/skills/ Claude Code Cursor Copilot Codex Antigravity

Agents look for skills in different folders. Selecting a skill’s checkbox creates links to its original folder in the project’s .claude/skills/ and .agents/skills/ folders. You edit the original in one place. Reading through these links has been checked with Claude Code, Codex, Copilot and Antigravity; Cursor has not yet been checked.

Share skills with worktrees in the same repository.

In Plugins & skills, expand Worktrees in this repository, select skills and worktrees, and preview the paths before applying. This adds missing skill links; it preserves existing folders and links and does not copy plugin settings, hooks or MCP configuration. You can save a default for new worktrees. While HUD is running, it checks every 15 seconds; run agent-hud worktrees apply before starting an agent if you need the links in place first. See the README for exclusions and session reload behavior.

It also finds the instruction files you scattered around.

31 kinds of CLAUDE.md, AGENTS.md, .cursor/rules/ and the rest, with size and modified time. Documents mentioned by path or link appear as related documents; they are read only when needed and are not in the startup totals. The timestamps show when you updated CLAUDE.md but left AGENTS.md on last month’s wording.

The Agent instructions tab

Frequently asked questions

Why macOS only?

The installer and app are built for macOS. On Linux, run server.py directly and configure a service manager such as systemd --user separately. macOS features such as the Finder folder picker are unavailable. Windows is not supported yet (#1).

What does it change on my computer?

ON/OFF switches update .claude/settings.local.json in the selected project. Skill linking and group application also change links in its skill folders. Worktree sharing adds missing links to the selected checkouts. Instruction files are read and displayed without being edited.

How do I undo it, or remove it?

Unassigning a group removes its skill links and restores the enabledPlugins and skillOverrides values it wrote. Values you changed yourself afterwards stay. Groups applied before v0.6.3 have no recorded values, so their settings stay; remove them from the project's .claude/settings.local.json if needed. Disable worktree automatic application separately; links it already created remain.

For a Homebrew install, stop the service with brew services stop agent-hud. If you installed the app, remove it with brew uninstall --cask agent-hud-app, then remove the command and server with brew uninstall agent-hud. For an install script setup, run launchctl bootout gui/$(id -u)/com.agent-hud and delete ~/Library/LaunchAgents/com.agent-hud.plist. The location of saved groups and projects depends on the installation method and AGENT_HUD_HOME. See where the data lives.

Do my other agents need setting up?

You can register a project regardless of which agent you use. ON/OFF switches update Claude Code settings only. For other agents, use the skill linking checkbox to link the original folder. Changing groups also adds or removes project links, which can change the skills other agents discover. Check the agent’s skill list to confirm changes have reached an existing session.

The whole thing is one Python file that uses nothing but the standard library. You can read it yourself, and it runs only on your computer. Nothing is uploaded and there is no account to make. On its own it makes one request: a GitHub Releases check once a day, to see whether a newer version exists. If you installed with Homebrew and click Update now, Homebrew downloads the new version. Token counts are optional: if you run the setup command, the tiktoken package and one public vocabulary file are downloaded once into the tool’s own folder, and counting then runs offline on your computer.