jarrodwatts/claude-hud

A Claude Code plugin that shows what's happening - context usage, active tools, running agents, and todo progress

解决的问题

Claude HUD 为 Claude Code 用户提供持久且实时的状态显示，无需手动检查上下文使用量、速率限制和代理活动。它通过在输入行下方添加一个可见的 HUD（抬头显示），改造终端界面，使关键的会话元数据始终可见。

工作原理

该插件作为 Claude Code 的状态行命令运行。它通过 stdin 接收会话数据（如模型、上下文窗口、成本和速率限制），并解析会话转录以跟踪活动工具、运行中的代理和待办事项进度。然后，它直接将格式化的状态行输出到终端，无需额外窗口或 tmux。

适用人群

希望更清晰地了解 LLM 资源消耗、项目状态（git 分支、路径）以及会话期间自主代理进展的 Claude Code 用户。

主要亮点

  • 资源监控：使用带颜色警告的视觉条形图显示上下文窗口使用量和订阅者速率限制。
  • 活动追踪：可选行用于监控活动工具、运行中的代理和待办事项列表进度。
  • 环境上下文：显示当前模型、提供者（如 Bedrock、Vertex）、项目路径和 git 分支状态。
  • 深度定制：支持布局（紧凑 vs 扩展）、元素顺序、颜色和语言支持（英文、简体中文、繁体中文）的丰富配置选项。
  • 成本追踪：可显示会话成本、每日累计支出和每周配额。

相关

  • 项目
    GaoSSR/best-claude-hud

    基于 Rust 的高性能状态行 HUD，为 Claude Code 显示实时模型信息、推理努力、Git 状态和上下文窗口使用情况。

  • 项目
    simple10/agents-observe

    一个为 Claude Code 和 Codex 代理提供实时可观测性的仪表板，可查看子代理层级结构、工具调用和 Token 使用情况。

  • 项目
    NoobyGains/claude-pulse

    无需 API 密钥，即可实时监控 Claude Code 的会话限制、成本和上下文使用情况的使用监控器和状态栏。

  • 项目
    leeguooooo/claude-code-usage-bar

    Claude Status Bar (`claude-statusbar`) is a small utility that adds a live usage bar to Claude Code’s terminal status line (or a floating HUD on macOS). It shows official 5‑hour/7‑day rate‑limit counters, reset timers, model name, context‑window fill, prompt‑cache warm‑up time and optional cost/balance, updating every second. Installable via a one‑line binary script or a pip package, it offers zero‑dependency binaries, fast native rendering, multiple visual styles, and optional git or language‑coach integrations.

  • 项目
    paulrobello/claude-office

    A real-time pixel art office simulation that visualizes Claude Code and OpenCode operations, turning agent logs into an animated environment with boss and employee agents.