做什么
一个 Claude 代码插件,该插件显示一个实时的 HUD 显示上下文的用法,活动工具,运行代理,以及终端状态线上的待办事宜进度.
技能库 智客分类:Agent 工作流 claude-hud-statusline
一个 Claude 代码插件,该插件显示一个实时的 HUD 显示上下文的用法,活动工具,运行代理,以及终端状态线上的待办事宜进度.
官方网址:skills.sh
先看中文介绍;官方 description 原文单独保留,不改写 SKILL.md。
一个 Claude 代码插件,该插件显示一个实时的 HUD 显示上下文的用法,活动工具,运行代理,以及终端状态线上的待办事宜进度.
官方 description 未单独写出 Use when。按规范,代理会在用户任务与这段 description 的关键词匹配时激活本技能。
按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:Claude HUD、What It Does、Requirements、Installation、What You See、Default 2-line layout。
文件分析:这是一份仅含 SKILL.md 的指令型技能,代理激活后整份正文进入上下文。
A Claude Code plugin that displays a real-time HUD showing context usage, active tools, running agents, and todo progress in your terminal statusline.
Claude HUDWhat It DoesRequirementsInstallationWhat You SeeDefault 2-line layoutWith optional lines enabledConfigurationInteractive configuration (recommended)Manual configurationKey Configuration OptionsLayout
来源分类:skills.sh agent-skill
nameclaude-hud-statuslinedescription具体调用语法与可用工具以目标 Agent 客户端为准。 查看调用机制说明 ↗
先选择目标 Agent 和安装范围,保留技能包的附属文件,安装后检查客户端能否发现该技能。
复制安装指令给支持 Agent Skills 的代理,确认其中的目标目录与客户端匹配。
把 Agent Skill「claude-hud-statusline」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-320a1f6af451a0c4-%E5%85%8B%E5%8A%B3%E5%BE%B7%C2%B7%E8%B5%AB%E5%BE%B7%E7%8E%B0%E7%8A%B6.html 请存为 .cursor/skills/claude-hud-statusline/SKILL.md 或 .claude/skills/claude-hud-statusline/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。
需要 Node.js 与 npx。先查看仓库技能列表,确认实际名称。
npx skills add 'https://github.com/reason-machines/trending-skills' --list
npx skills add 'https://github.com/reason-machines/trending-skills' --skill 'claude-hud-statusline'
CLI 会交互选择目标 Agent,默认安装到项目;用户级安装使用 -g。先通过查看命令核对仓库内容,再用 npx skills list 检查已安装技能。
name: claude-hud-statusline description: A Claude Code plugin that displays a real-time HUD showing context usage, active tools, running agents, and todo progress in your terminal statusline. triggers:
Skill by ara.so — Daily 2026 Skills collection.
Claude HUD is a Claude Code plugin that adds a persistent statusline to your terminal showing real-time context window usage, active tool calls, running subagents, and todo progress — always visible below your input prompt.
| Feature | Description | |---------|-------------| | Context health | Visual bar showing how full your context window is (green → yellow → red) | | Tool activity | Live display of file reads, edits, and searches as they happen | | Agent tracking | Shows which subagents are running and what they're doing | | Todo progress | Real-time task completion tracking | | Usage limits | Claude subscriber rate limit consumption | | Git status | Current branch, dirty state, ahead/behind remote |
Run these commands inside a Claude Code session:
Step 1: Add the marketplace
/plugin marketplace add jarrodwatts/claude-hud
Step 2: Install the plugin
/plugin install claude-hud
Linux users: If you get
EXDEV: cross-device link not permitted, set TMPDIR first:mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude
Step 3: Configure the statusline
/claude-hud:setup
Windows users: If setup reports no JavaScript runtime, install Node.js LTS first:
winget install OpenJS.NodeJS.LTS
Step 4: Restart Claude Code to load the new statusLine config.
[Opus] │ my-project git:(main*)
Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)
[Opus] │ my-project git:(main*)
Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h)
◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2
◐ explore [haiku]: Finding auth code (2m 15s)
▸ Fix authentication bug (2/5)
/claude-hud:configure
This opens a guided flow with preset options:
| Preset | Shows | |--------|-------| | Full | Everything — tools, agents, todos, git, usage, duration | | Essential | Activity lines + git, minimal clutter | | Minimal | Model name and context bar only |
Edit ~/.claude/plugins/claude-hud/config.json directly:
{
"lineLayout": "expanded",
"pathLevels": 2,
"elementOrder": ["project", "context", "usage", "tools", "agents", "todos"],
"gitStatus": {
"enabled": true,
"showDirty": true,
"showAheadBehind": true,
"showFileStats": false
},
"display": {
"showModel": true,
"showContextBar": true,
"contextValue": "percent",
"showUsage": true,
"usageBarEnabled": true,
"showTools": true,
"showAgents": true,
"showTodos": true,
"showDuration": false,
"showSpeed": false,
"showConfigCounts": false,
"showMemoryUsage": false,
"showSessionName": false,
"showClaudeCodeVersion": false,
"sevenDayThreshold": 80,
"showTokenBreakdown": true
},
"colors": {
"context": "green",
"usage": "brightBlue",
"warning": "yellow",
"usageWarning": "brightMagenta",
"critical": "red",
"model": "cyan",
"project": "yellow",
"git": "magenta",
"gitBranch": "cyan",
"label": "dim",
"custom": "208"
}
}
{
"lineLayout": "expanded", // "expanded" (multi-line) or "compact" (single line)
"pathLevels": 1 // 1-3 directory levels in project path
}
Path level examples:
1 → [Opus] │ my-project git:(main)2 → [Opus] │ apps/my-project git:(main)3 → [Opus] │ dev/apps/my-project git:(main){
"display": {
"contextValue": "percent" // "45%"
// "contextValue": "tokens" // "45k/200k"
// "contextValue": "remaining" // "55% remaining"
// "contextValue": "both" // "45% (45k/200k)"
}
}
{
"elementOrder": ["project", "context", "usage", "memory", "environment", "tools", "agents", "todos"]
}
Omit any entry from the array to hide it entirely.
{
"gitStatus": {
"enabled": true,
"showDirty": true, // "main*" for uncommitted changes
"showAheadBehind": true, // "main ↑2 ↓1"
"showFileStats": true // "main* !3 +1 ?2" (modified/added/deleted/untracked)
}
}
Supported values: named colors (dim, red, green, yellow, magenta, cyan, brightBlue, brightMagenta), 256-color numbers (0-255), or hex (#rrggbb).
{
"colors": {
"context": "#00FF88",
"model": "208",
"project": "#FF6600"
}
}
Claude HUD uses Claude Code's native statusline API — no separate window, no tmux needed:
Claude Code → stdin JSON → claude-hud → stdout → terminal statusline
↘ transcript JSONL (tools, agents, todos parsed live)
{
"lineLayout": "compact",
"display": {
"showModel": true,
"showContextBar": true,
"contextValue": "percent",
"showUsage": false,
"showTools": false,
"showAgents": false,
"showTodos": false
}
}
{
"lineLayout": "expanded",
"pathLevels": 2,
"gitStatus": {
"enabled": true,
"showDirty": true,
"showAheadBehind": true,
"showFileStats": true
},
"display": {
"showTools": true,
"showAgents": true,
"showTodos": true,
"showDuration": true,
"showMemoryUsage": true,
"showConfigCounts": true,
"contextValue": "both",
"showTokenBreakdown": true
}
}
{
"display": {
"showUsage": true,
"sevenDayThreshold": 0
}
}
Output: Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h) | ██████████ 85% (2d / 7d)
HUD not appearing after setup
claude in terminal)Config not applying
cat ~/.claude/plugins/claude-hud/config.json | node -e "JSON.parse(require('fs').readFileSync('/dev/stdin','utf8'))"/claude-hud:configure to regenerateGit status missing
git status)gitStatus.enabled is not false in configTool/agent/todo lines not showing
showTools, showAgents, showTodosUsage limits not showing
Bedrock label; usage is managed in AWS console insteadrate_limits won't show subscriber usageLinux cross-device error on install
mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude
# Then run /plugin install claude-hud inside that session
Windows: no JavaScript runtime found
winget install OpenJS.NodeJS.LTS
# Restart shell, then run /claude-hud:setup again
| Command | Description |
|---------|-------------|
| /plugin marketplace add jarrodwatts/claude-hud | Register the plugin source |
| /plugin install claude-hud | Install the plugin |
| /claude-hud:setup | Initial setup wizard, writes statusLine config |
| /claude-hud:configure | Interactive configuration with preview |
~/.claude/plugins/claude-hud/config.json
Agent 工作流
创造有效技能指南。 当用户想创造出新的技能(或更新现有的技能),以专业知识,工作流程,或工具集成来扩展克洛德的能力时,应该使用这种技能.
Agent 工作流
使用ClawdHub CLI搜索,安装,更新并发布从taladhub.com的代理技能. 需要获取苍蝇上的新技能时使用,将安装的技能同步到最新版本或特定版本,或者发布 npm-instainddhub CLI 的新/更新的技能文件夹.
Agent 工作流
管弦乐团多代理团队,任务设定周期,交接协议,审查工作流程. 使用时间: (1)建立2+特派员队伍,具有不同专业,(2)确定任务路线和生命周期(收录框_ spec_建设_审查_完成),(3)在特派员之间制定交接协议,(4)建立审查和质量关口,(5)管理特派员之间的交流和文物共享.
Agent 工作流
Spec-first,TDD,子代理驱动的软件开发工作流程. 当:(1)构建任何新功能或应用——触发脑暴_计划_子代理执行回路,(2)调试出一个bug或测试失败——触发系统性的根起过程,(3)用户说"让我们构建","帮助我计划","我想添加X",或"这个被打破",(4)完成一个功…