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。