hoobnn-agent-mods

hoobnn-agent-mods

Claude Code 状态栏 HUD，附带任务进度条、回合回执、运行动画等 mod。

简体中文 · English

hud 把 claude-hud 改成了 Claude Code mod：模型、项目、git、上下文、用量、正在跑的工具、子代理和待办都集中在输入框旁边，可以放在输入框上方，也可以放在下方原来状态栏的位置，终端和 Claude Desktop 都能用。在 claude-hud 的基础上，它还加了额度预警、用量耗尽预测、每日预算、一行任务摘要、/hud detail 详情面板和 12 套主题。

快速开始

装好后 HUD 默认显示在输入框上方。用 /hud theme 选主题，/hud detail 打开详情面板，/hud off / /hud on 隐藏或显示。已有的 claude-hud 配置（~/.claude/plugins/claude-hud/config.json）会直接沿用。

HUD 功能

- claude-hud 原有的信息：模型和推理强度、项目和 git 分支及改动、上下文和用量进度条、正在跑的工具、子代理和待办。
- 提前预警：上下文或额度到设定的百分比时弹提示；按当前速度预测额度何时用完；Fable 这类按模型单独计的周额度也一起显示和预警；距自动压缩还剩多少 token。
- 省钱提醒：提示缓存过期后，提醒下一条消息要重新写入多少 token；某一轮让上下文涨得特别多时，显示涨幅和最近几轮的迷你柱状图（如 上一轮 +98k ▂▁█）；今天的花费对比每日预算。
- 任务概览：每隔几轮生成一行任务摘要；/hud detail 面板列出每个工具的调用次数和耗时、最近几轮的用时和花费、子代理、待办、今天和本周的花费。
- 其他：未提交改动或未推送提交太多时提醒；长任务结束提醒（macOS 可加提示音）；远程控制的连接状态。
- 12 套主题：classic、neon、rainbow、emoji、sakura、kawaii、mecha、shonen、tokyo-night、matrix、nerd、powerline，其中动漫风主题带会随状态变脸的颜文字看板娘。

12 套主题总览

完整的命令、选项和实现细节见 claude-code/hud。

更多 mod

spinner（clawd 主题跑完一轮，宠物伴侣的气泡跟着工具变化，最后放庆祝动画；15 套主题的动图见 claude-code/spinner）：

截图均由 mod 实际绘制的内容渲染。

安装

先添加本仓库的插件市场，再安装需要的 mod，每个 mod 都可单独安装、开箱即用：

更新

卸载

使用

选项（hud 的 position、theme、dailyBudgetUsd、summaryEveryTurns，ts-band 的 nodes、hideOffline，hitokoto 的 refreshMode、categories，spinner 的 theme、stage、celebrate、companion 等）都能在 /config 里改，也可以写在 ~/.claude/settings.json 的 pluginConfigs 里。所有 mod 设置统一保存在 /config，斜杠命令修改的设置（/hud theme neon、/ts off、/spinner stage off）也会写回这里；每个 mod 都有 visible 选项，/hud、/ts、/hitokoto、/spinner、/todos、/receipt、/relay 的 off / on 改的就是它。每个 mod 的完整说明见各自目录下的 README。

这些 mod 都支持英语、简体中文、繁体中文、日语、韩语、西班牙语、法语、德语、巴西葡萄牙语和俄语。hud 跟随 claude-hud 配置里的 language；ts-band、hitokoto、spinner、todo-bar、receipt 和 relay-bar 有各自的 language 选项，默认 auto，依次跟随 Claude Code 的 language 设置、系统语言环境，都没有时用英语。

仓库结构

Claude Code…