jarrodwatts/claude-hud

解决的问题

Claude HUD 是一个 Claude Code 插件，在用户输入下方提供一个实时、始终可见的状态栏 (HUD)。它解决了用户无法直观查看 Claude Code 会话内部状态（如上下文窗口使用情况、活动工具和智能体进度）的问题，而无需用户手动查询系统。

工作原理

该插件利用 Claude Code 的原生 statusline API。它处理来自 stdin 和 transcript JSONL 文件的 JSON 数据，以提取有关 token、工具活动和智能体状态的信息。然后，它将这些信息作为格式化的状态栏在终端中渲染，并在每次交互后进行重新渲染，并带有 300ms 的防抖处理以确保流畅的性能。

适用对象

使用 Claude Code 并希望能够随时一眼掌握会话资源使用情况、项目上下文和 AI 当前活动的开发人员。

亮点

• 实时监控：跟踪上下文健康状况（带有可视化进度条）、使用率限制和会话时长。
• 工具与智能体追踪：显示活动工具（read, edit, search）和正在运行的子智能体状态。
• 项目上下文：显示当前项目路径和 Git 分支状态（包括未提交状态）。
• 高度可定制：提供预设（Full, Essential, Minimal）以及用于布局、颜色和语言（English, Simplified Chinese, Traditional Chinese）的深度配置系统。
• 原生集成：在任何终端中运行，无需单独的窗口或 tmux。