# Claude HUD — Statusline Dashboard for Claude Code

> Claude HUD is a Claude Code plugin that shows context usage, active tools, running agents, and todo progress in your statusline for long runs.

## Install

Save the content below to `.claude/skills/` or append to your `CLAUDE.md`:

## Quick Use

1. Install / set up:
   ```bash
   # Inside Claude Code
/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
   ```
2. Start / smoke test:
   ```bash
   # Inside Claude Code
/claude-hud:setup
/reload-plugins
   ```
3. Verify:
   - Confirm the HUD renders below your input and the context/tool/agent/todo indicators update while you run a small multi-step task.

## Intro

Claude HUD is a Claude Code plugin that shows context usage, active tools, running agents, and todo progress in your statusline for long runs.

- **Best for:** Claude Code users who need visibility into long runs (context, tools, subagents, and todos)
- **Works with:** Claude Code plugins + statusline; supports Windows/macOS/Linux with a JS runtime
- **Setup time:** 5 minutes

## Practical Notes

- Setup time ~5 minutes (install plugin + run `/claude-hud:setup`)
- Quantitative signal: context usage % changes as you work; update loop is designed to refresh frequently
- GitHub stars + forks (verified): see Source & Thanks

Claude HUD is worth installing if you regularly hit two problems:

1. You don't know when context is getting tight until behavior changes.
2. Multi-agent sessions feel "black box" — you can’t tell what tools are being used or why progress stalls.

Adopt a simple operating routine:

- Watch context usage before starting large edits.
- When progress stalls, check tool activity / agent state first (not the model).
- Treat todos as a contract: break work into 3–7 items so the HUD stays meaningful.

### FAQ

**Q: Is this an official Claude Code feature?**
A: No. It's an open-source plugin that uses Claude Code’s plugin + statusline capabilities.

**Q: What does it show?**
A: At a glance: context usage, tool activity, running agents, and todo progress.

**Q: How do I uninstall?**
A: Remove the plugin from your Claude Code plugins and undo the statusline config changes if needed.

## Source & Thanks

> Source: https://github.com/jarrodwatts/claude-hud
> License: MIT
> GitHub stars: 22,392 · forks: 982

---

<!-- ZH -->

## 快速使用

1. 安装 / 设置：
   ```bash
   # Inside Claude Code
/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
   ```
2. 启动 / 冒烟测试：
   ```bash
   # Inside Claude Code
/claude-hud:setup
/reload-plugins
   ```
3. 验证：
   - 确认 HUD 出现在输入框下方；跑一个多步骤小任务，观察 context/工具/agent/todo 指示是否实时更新。

## 简介

Claude HUD 是 Claude Code 的插件：把 context 占用、工具活动、子 agent 状态与 todo 进度实时显示在状态栏，方便你在长对话/多 agent 时控节奏。

- **适合谁：** 经常跑长任务/多 agent 的 Claude Code 用户，需要一眼看到上下文/工具/进度
- **可搭配：** Claude Code 插件与 statusline；Windows/macOS/Linux 需要可用的 JS 运行时
- **准备时间：** 5 分钟

## 实战建议

- 准备时间约 5 分钟（安装插件 + 执行 `/claude-hud:setup`）
- 可量化信号：context 占用百分比会随对话增长而变化，便于把控压缩/遗忘风险
- GitHub stars / forks（已核验）：见「来源与感谢」

当你遇到两类问题时，Claude HUD 的价值会很高：

1) 上下文快满了却不自知，直到行为突然变差。
2) 多 agent 变成黑盒，卡住时不知道在干什么。

推荐的使用习惯：

- 开始大改动前先看 context 占用。
- 卡住先看工具活动/agent 状态，而不是先换模型。
- todo 当成契约：把任务拆成 3–7 条，HUD 才能持续给你有效信号。

### FAQ

**这是官方功能吗？**
答：不是，是基于 Claude Code 插件与 statusline 能力实现的开源插件。

**主要能看到什么？**
答：context 占用、工具活动、子 agent 状态与 todo 进度。

**怎么卸载？**
答：在 Claude Code 里移除插件，并按需回滚 statusline 配置。

## 来源与感谢

> Source: https://github.com/jarrodwatts/claude-hud
> License: MIT
> GitHub stars: 22,392 · forks: 982


---
Source: https://tokrepo.com/en/workflows/claude-hud-statusline-dashboard-for-claude-code
Author: Skill Factory