hoobnn/hoobnn-agent-mods/tree/main/claude-code/hud

将 claude-hud 0.10.0 改成 mod,把模型、Git、上下文、工具、子代理和待办集中在输入框旁;增加额度预警、每日预算、详情面板与 12 套主题,工作状态一眼可见。
hoobnn/hoobnn-agent-mods/tree/main/claude-code/hud

hud 将 claude-hud 0.10.0 改成 Claude Code mod,把模型与推理强度、项目与 Git 改动、上下文和用量进度条、运行中的工具、子代理和待办集中在输入框旁。可放在输入框上方,也可放到下方原有状态栏的位置。
在原有仪表盘基础上,它增加了可设定阈值的上下文与额度预警、额度耗尽时间估算、自动压缩前的剩余 token,以及未提交改动或未推送提交过多时的提醒。五小时额度预测使用最近一小时的消耗速度。花费视图将今天的花费与每日预算对照,并提供近七天迷你折线图。一行任务摘要保留当前工作重点;/hud detail 详情面板展示工具调用次数与耗时、最近几轮用时、花费和上下文增长,以及子代理、待办、今日与本周花费,Claude 工作时也能打开。长任务结束可触发提醒,macOS 可附提示音,并显示远程控制的连接状态。
12 套主题为 classic、neon、rainbow、emoji、sakura、kawaii、mecha、shonen、tokyo-night、matrix、nerd 和 powerline;后两套需要 Nerd Font。动漫风角色会随工作、上下文与额度状态变脸,可用 showMascot 关闭。/hud theme <名字> 立即切换,/hud theme 打开选择窗口,/hud theme next 换下一套,/hud theme reset 恢复 classic,选择会通过 /config 的 theme 保存。/hud 切换显示;/hud on、/hud off 直接设定,输入框底栏的 HUD 按钮也可操作。
可以沿用 ~/.claude/plugins/claude-hud/config.json 与 ~/.claude/claude-hud.json 中的既有设置,/claude-hud:configure 仍可使用。安装命令:
claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install hud@hoobnn-agent-mods
来源:https://github.com/hoobnn/hoobnn-agent-mods/tree/main/claude-code/hud 原版 claude-hud:https://github.com/jarrodwatts/claude-hud
请先查看作者 README 确认 marketplace 和插件名称;命令可能随仓库结构改变。
claude plugin marketplace add hoobnn/hoobnn-agent-mods claude plugin install hud@hoobnn-agent-mods
简体中文 · English
把 claude-hud 0.10.0 改成了 Claude Code mod:模型、项目、git、上下文、用量、正在跑的工具、子代理和待办,都集中在输入框旁边。可以放在输入框上方,也可以放在下方原来状态栏的位置。在 claude-hud 的基础上,还加了额度预警、用量耗尽预测、每日预算、一行任务摘要、详情面板,以及 12 套随时切换的主题。

/hud detail 详情面板:每个工具的调用次数和耗时、最近几轮的用时、花费和上下文增长、子代理、待办、今天和本周的花费。claude plugin marketplace add hoobnn/hoobnn-agent-mods
claude plugin install hud@hoobnn-agent-mods
它读取 claude-hud 自己的配置文件(~/.claude/plugins/claude-hud/config.json 和 ~/.claude/claude-hud.json),已有的 claude-hud 设置可以直接沿用,/claude-hud:configure 也照常可用。
用 /hud theme <名字> 立即切换;只输入 /hud theme 会弹窗选择;/hud theme next 换下一套,/hud theme reset 回到 classic。选择会写回 /config 的 theme 选项,以后的会话也会沿用。
| 主题 | 风格 |
| --- | --- |
| classic | claude-hud 原样 |
| neon | 赛博朋克:霓虹真彩色,⬢ ◆ ◈ ⚡,▰▱ 进度条,❯ 分隔 |
| rainbow | 每个元素一种颜色,进度条和模型名是彩虹渐变 |
| emoji | 🤖 📂 🌿 🧠 ⚡ 📅 ⏳ ✅ |
| sakura | 樱花粉,🌸 🎀 🍡 💗,✿ 进度条,颜文字看板娘 (◕‿◕)♡ |
| kawaii | 马卡龙色,「Opus」,●○ 进度条,猫咪看板娘 ฅ^•ω•^ฅ |
| mecha | 紫、绿、橙,UNIT·Opus◤,SYNC / PWR 仪表,机器人看板娘 [•_•] |
| shonen | 红橙金,🔥 ⭐ 🍥 💥,渐变进度条,热血看板娘 (ง •̀_•́)ง |
| tokyo-night | Tokyo Night 配色,图标克制 |
| matrix | 黑底绿字,▮▯ 进度条,┊ 分隔 |
| nerd | Nerd Font 图标(需要 Nerd Font) |
| powerline | Nerd Font 图标加 powerline 色块(需要 Nerd Font) |
同一个示例会话在 12 套主题下的样子:assets/themes/gallery.png;每套主题的单图在 assets/themes/<主题>.png。
动漫风主题的看板娘会跟着状态变脸:平时很淡定,跑工具时忙碌,上下文到 70%(或额度到 90%)开始担心,85% 慌张,用量耗尽时直接晕倒。showMascot 可以关掉它。
/hud:显示或隐藏 HUD;/hud off、/hud on 直接设定(输入框底栏的 HUD 按钮也一样)。/hud theme [名字|next|reset]:切换主题。/hud detail:打开或关闭详情面板。Claude 工作时也能用。在 /config 里修改,或写在 ~/.claude/settings.json 的 pluginConfigs 里:
| 选项 | 作用 | 默认 |
| --- | --- | --- |
| visible | 显示 HUD | 开 |
| footerButton | 在输入框底栏显示 HUD 开关按钮 | 开 |
| position | above 放在输入框上方,below 放在下方原状态栏的位置 | above |
| theme | 主题 | classic |
| showMascot | 动漫风主题显示颜文字看板娘 | 开 |
| contextAlerts | 上下文到这些百分比时提醒,逗号分隔,如 80,90;留空关闭 | 空 |
| usageAlerts | 5 小时或 7 天额度到这些百分比时提醒;留空关闭 | 空 |
| showForecast | 按当前速度会在重置前用完时,显示预计用完的时间 | 开 |
| compactWarnPercent | 上下文到达自动压缩阈值的这个百分比后,显示还剩多少 token;0 关闭 | 60 |
| dailyBudgetUsd | 每日预算(美元),显示今天的花费对比;0 关闭 | 0 |
| showHistory | 显示近 7 天花费折线和连续使用天数 | 关 |
| summaryEveryTurns | 第一轮后和每隔几轮生成一行任务摘要(复用提示词缓存);0 关闭 | 5 |
| notifyAfterSeconds | 一轮跑了这么多秒以上才在结束时提醒;0 关闭 | 0 |
| notifySound | 结束提醒带提示音(macOS) | 开 |
| gitDirtyWarn | 未提交的改动达到这么多个路径时提醒;0 关闭 | 20 |
| gitAheadWarn | 未推送的提交达到这么多个时提醒;0 关闭 | 5 |
| showAgents | 显示 claude-hud 的子代理行(Claude Code 自己已经会列出,默认关) | 关 |
| extraCmd | claude-hud 的 --extra-cmd:一条 shell 命令,输出作为一个标签(需要 CLAUDE_HUD_ALLOW_EXTRA_CMD=1) | 空 |
| debug | 注册 mcp__hud__hud_debug 调试工具 | 关 |
语言跟随 claude-hud 配置文件里的 language(en、zh-Hans、zh-Hant、ja、ko、es、fr、de、pt-BR、ru),mod 新加的预警、面板、/hud 回复和任务摘要也一起跟随。
hoobnn-agent-mods 里还有任务进度条(todo-bar)、回合回执(receipt)、运行动画和宠物(spinner)、Tailscale 节点状态(ts-band)和一言(hitokoto),可以搭配使用。
和 claude-hud 的差异、mod 自行推算的字段、目录结构和从上游同步的步骤,见 英文 README。
这是你的项目吗?把这个徽章放进 README 或网站,链接回本页。