hud in action

hud

hud · by hoobnn

claude-hud 0.10.0 as a mod: model, project, git, context, usage, tools, agents, todos, alerts, budget, history, task summary, themes.

❯ /plugin marketplace add SeongGwangJu/k-mods
❯ /plugin install hud@k-mods

Run /reload-plugins to apply it to an open session. Needs Claude Code 2.1.287 or later.

Notes

  • This is [jarrodwatts/claude-hud](https://github.com/jarrodwatts/claude-hud) 0.10.0 ported to a mod, and it keeps the original copyright under a separate LICENSE.claude-hud (MIT, Jarrod Watts). The display language follows the language field (default en) in claude-hud's own config file (~/.claude/plugins/claude-hud/config.json or ~/.claude/claude-hud.json), not k-mods' /config. plugin.json userConfig has no language option, so we did not recommend a language setting here.
  • Every summaryEveryTurns turns (default 5, can be turned off with 0), a model call summarizes the session's work in one line. It forks the conversation to reuse the prompt cache, so the cost is small, but it does use your usage.
  • extraCmd (claude-hud's --extra-cmd, which runs an arbitrary shell command) is empty by default. To use it, you must turn on both the option setting and the CLAUDE_HUD_ALLOW_EXTRA_CMD=1 environment variable.
  • The features that show your account auth method and part of your email (claude-hud's showAuth/showAuthUser) and the files that share usage with other local tools (externalUsagePath/externalUsageWritePath) can only be turned on in claude-hud's own config file, and both are off by default.
  • With the same author's (hoobnn) original spinner mod, the pet is shown next to the HUD (when in the below position). It does not pair with k-mods' pixel-pals, and works normally without it.

Requires

  • Nerd Font (only needed for the nerd and powerline themes)

What it can do on your machine

Mods run unsandboxed with your permissions. These labels come from static analysis.

Runs programsWrites filesCalls a modelCan hold/answer tool callsReads conversationReads env/settingsReads filesPlays sound
Static analysis

Events handled

command.runcommand.run{command=hud}prompt.editprompt.submitsession.attachsession.compactsession.detachsession.measuresession.receivesession.startstate.set{plugin=spinner, key=dock}tool.calltool.call{tool=/"^mcp__hud__hud_debug$"/}turn.completeturn.startturn.stepui.messageui.render{component=AbovePrompt}ui.render{component=Pane, requestId=hud-detail}ui.render{component=PromptHint}ui.render{component=SessionMode}