hud
Reviewed
at commit 0a2174b
New version, not yet reviewed
The claude-hud statusline as a mod above or below the prompt, with quota alerts, a usage forecast, a daily budget, a one-line task summary forked from the…
0 upvotes
Log in to upvote or save- Made by
- hoobnn
- Pinned commit
-
0a2174b097ac81cc35b5ed3d440ef617008b79bc - What we checked
-
Draws claude-hud's status lines above or below the prompt, and as cards in Claude Desktop, the phone app and VS Code: model, project, git, context, usage limits, tools, todos, spend, alerts and themes. It reads your session transcript, Claude config files and git status, and keeps a daily spend ledger under ~/.claude/plugins/claude-hud-mod. By default it asks Claude for a one-line task summary every 5 turns, which uses tokens.
Review details
Static review of the source at the pinned commit; not run. Full re-review (the diff since 60ee5dd was too large for a delta review), with close reading of what changed. Registers session.start, command.run (/hud: off, on, off all, on all, detail, theme), ui.render (AbovePrompt, PromptHint when position is below, a SessionMode footer button now off by default, the hud-detail Pane), prompt.submit, prompt.edit, prompt.change, session.attach, session.detach, session.receive, session.measure, session.compact, state.set (spinner.dock), ui.message, tool.call, turn.step, turn.start and turn.complete. All handlers pass events through unchanged; tool.call only times and counts each call (a second tool.call hook answers only its own optional mcp__hud__hud_debug tool, off by default, which returns the rendered lines, the built stdin, the paths and commands it fetched and the last error). It bundles claude-hud's MIT source behind shims that route Node fs and child_process through $.fs and $.process.run. New in this version: the terminal and the apps have separate visible switches (visible, visibleApp written through $.config.set); on Claude Desktop, the phone and VS Code it draws the readings as tiles with inline SVG bars and a Details button that opens its pane; Windows support, where named variables come from $.env.get (HOME, USERPROFILE, CLAUDE_CONFIG_DIR, TMPDIR, TEMP, OS, COLUMNS, DEBUG, LANG, LC_ALL, LC_TIME) instead of /usr/bin/env -0, the transcript is located by listing ~/.claude/projects through $.fs.list instead of /usr/bin/find, and it is read incrementally by a fixed powershell.exe -NoProfile script that gets the path and offset through environment variables (on macOS and Linux still /bin/sh -c tail|head with positional arguments); git is hardened against repository-level config: it lists filter drivers with git config --show-scope --get-regexp and passes -c core.fsmonitor=false and empty clean/process for drivers not from global or system config, adds --ignore-submodules=dirty and uses read-only git diff-index instead of git diff; an opt-in subagent effort label (showAgents and showAgentEffort, both off by default) runs grep -m 4 on subagent transcripts under the session's own transcript folder, with the agent id restricted to a plain token; the turn-done notice (notifyAfterSeconds, off by default) now also calls $.ui.notify; forecast wording, narrow-terminal layout, transcript parsing fixes and grapheme-safe truncation. Other programs it runs: git status/rev-parse/describe (read-only, optional locks off), uname, sysctl hw.memsize, macOS defaults read for the locale, vm_stat when memory display is on, jj log only when enabled in claude-hud's config, and /bin/rm -f only for files its own overlay deleted (its temporary files). The environment is read into memory for config paths, locale, provider label and the presence of ANTHROPIC_API_KEY; it is not written or sent anywhere. Reads ~/.claude.json (cached usage windows, and the oauthAccount plan and email local part only when showAuth/showAuthUser are set), settings.json files, .mcp.json and rules folders (counts only, when showConfigCounts is set), sessions/<pid>.json every 3 s for Remote Control, and claude-hud's own config.json. Writes daily-cost.json and, with showSpeed, speed-cache/*.json under ~/.claude/plugins/claude-hud-mod (cost and token figures only), an external usage snapshot only at a path the user sets in claude-hud's config, its own /config rows via $.config.set and spend history via $.store. $.model.fork runs the task summary after the first turn and every summaryEveryTurns turns (default 5, 0 turns it off), skipped while a todo list has open items. The extraCmd option runs a user-supplied shell command only when it is set and CLAUDE_HUD_ALLOW_EXTRA_CMD=1, both disclosed. Optional toasts, notifications and a chime ($.audio.play) are off by default. No network calls; the only URLs are clickable links to the GitHub branch and the claude.ai Remote Control session, and the MiniMax endpoints are only compared with ANTHROPIC_BASE_URL for a provider label. Read in full: manifest, hooks.json, register.tsx, types, config, draw.tsx, live.ts, remote.ts, render.ts, summary.ts, hooks/stdin.ts, hud/stdin.ts, the host shim, and the diffs of git.ts, transcript.ts, auth.ts, external-usage.ts, extra-cmd.ts, jj.ts, effort.ts, model-source.ts, hud/index.ts, hud/config.ts, sanitize, truncate, the path shim and band.tsx. Unchanged since the previous review and covered by it plus targeted search: the fs, child_process and other shims, daily-cost.ts, speed.ts, memory.ts, config-reader.ts, claude-config-dir.ts, transcript-feed.ts. Covered by targeted search only: extras.ts, i18n.ts, themes, render/* formatting modules and the claude-hud i18n strings. The not-included hooks/shims/node-globals.d.ts is a type declaration and is not loaded at runtime.
- What it uses
-
- Reads your prompts: yes
- Sees tool calls: yes
- Blocks or changes tool calls: no
- Reads or writes files: yes
- Runs programs on your machine: yes
- Calls the model (uses tokens): yes
- Sends data over the network: no
- Stores data: yes
- Shows something on screen: yes
claude-hud 0.10.0 as a mod: model, project, git, context, usage, tools, agents and todos, plus alerts, budget, history, a task summary, a detail pane and switchable themes
Made this mod? Add a badge to your README
Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.
[](https://modsforclaude.com/mods/hud/)