Guccbai/claude-hud/tree/main/desktop
hud-desktop
A HUD plugin for the Code page in the Claude desktop app. It shows the folder, running subagents, context usage, weekly allowance, cost, cache and activity above the input box, with three layouts switched by /hud.
About this mod
hud-desktop is an information-bar plugin above the input box on the Code page of the Claude desktop app; use the Rust status bar in the terminal. It shows the folder, running subagents (dots, grouped in fours), context usage, weekly allowance, cost, cache and activity; when there are no subagents, it shows none. It provides three layouts: dashboard (five rows, no cards, including cumulative token count and the most recent request), single line (only the most important information), and cards (four cards, the default). Use /hud 1, /hud 2 or /hud 3 to choose a layout; /hud without an argument rotates to the next one. The choice is stored in $.store and retained for the next session. To install, put this directory at ~/.claude/claude-hud/desktop and add CLAUDE_CODE_PLUGIN_DIRS pointing to it in the env section of ~/.claude/settings.json; use claude plugin validate . and claude plugin test . to check it. Note that the plugin is named hud-desktop; names beginning with claude- are reserved by Claude Code.
Installation
Check the author's README for the marketplace and plugin name first. Commands may change as the repository evolves.
claude plugin marketplace add Guccbai/claude-hud claude plugin install hud-desktop
Original text / README
hud-desktop
Claude 桌面版 Code 页的 HUD。HUD 是输入框上方的一条信息栏。
它显示:文件夹、运行中的子代理(圆点)、上下文用量、每周额度、费用、缓存、活动。 终端里不显示,终端用 Rust 版状态栏。
插件名是 hud-desktop。claude-hud 不能用:claude- 开头的名字被 Claude Code 保留。
布局
| 编号 | 名字 | 样子 | | --- | --- | --- | | 1 | 仪表盘 | 五行,没有卡片。多了累计 token 和最近一次请求 | | 2 | 单行 | 一行,只放最要紧的 | | 3 | 卡片 | 四张卡片(默认) |
子代理:每个运行中的子代理一个圆点,四个一组。没有子代理时不显示。
切换
/hud 1、/hud 2、/hud 3:选一个布局。/hud:不带参数,轮换到下一个。
选择存在 $.store 里,下次会话还在。
加载
把本目录装到 ~/.claude/claude-hud/desktop,再在 ~/.claude/settings.json 的 env 里加:
{ "env": { "CLAUDE_CODE_PLUGIN_DIRS": "~/.claude/claude-hud/desktop" } }
检查
claude plugin validate .
claude plugin test .
