CC-HUD

A compact, single-line statusline plugin for Claude Code
_{Crash-free, zero-dependency status bar — model · context · agents · rate limits · reset countdown}

Model  →  Context  →  Agents  →  Rate Limits
_{everything you need, nothing you don't.}

Why CC-HUD?

为什么做 CC-HUD？

[!TIP]
Windows users: Use npm i -g @anthropic-ai/claude-code instead of the native installer to avoid Bun crashes entirely.

Windows 用户： 建议用 npm i -g @anthropic-ai/claude-code 代替原生安装器，彻底规避 Bun 崩溃。

Features

Install

Inside Claude Code:

/plugin marketplace add WaterTian/cc-hud
/plugin install cc-hud@cc-hud
/reload-plugins
/cc-hud:setup        # only if no statusLine is configured yet

Done — no restart needed; /reload-plugins hot-loads the HUD.

[!NOTE]
/cc-hud:setup writes the statusLine entry into ~/.claude/settings.json. Skip it if you already have a statusLine configured (e.g. via cc-bot, an older install, or hand-edited settings).

Upgrade

/plugin marketplace update cc-hud
/reload-plugins

npm i -g cc-hud

Add to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "npx cc-hud",
    "padding": 2
  }
}

git clone https://github.com/WaterTian/cc-hud.git
cd cc-hud && npm install && npm run build

Add to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "node /absolute/path/to/cc-hud/dist/index.js",
    "padding": 2
  }
}

How It Works

Claude Code ─── stdin JSON ──→ cc-hud ──→ stdout ──→ status bar
             │  (model, context, rate_limits.resets_at)
             ↘ transcript JSONL (tail 64KB → active agents)

Balance Display (DeepSeek)

When using DeepSeek as the backend (ANTHROPIC_BASE_URL set to https://api.deepseek.com/anthropic), cc-hud automatically shows your account balance — zero configuration required.

[DeepSeek V4 Pro] ██░░░░░░░░ 20% │ ¥13.44

Balance is cached locally for 5 minutes. On cache miss, cc-hud fetches the latest balance from DeepSeek's API. Works with dscode, deepseekcode, or any launcher that sets ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN.

For other backends (GLM, custom endpoints), set CC_HUD_EXTRA_FILE env var to a file whose first line is the text to display. See scripts/ds-balance-cache.sh for a reference cache implementation.

Quota Display (MiniMax)

When using MiniMax M3 as the backend (ANTHROPIC_BASE_URL set to https://api.minimaxi.com/anthropic), cc-hud automatically shows your Token Plan quota — zero configuration required.

[MiniMax M3] █▎░░░░░░░░ 13% │ 5h:17% (1.1h) │ 7d:2% (6.4d)

Token Plan usage (5h interval ＋ weekly) is fetched from MiniMax's /v1/token_plan/remains endpoint, cached locally for 5 minutes. Model names are beautified automatically: MiniMax-M3 → MiniMax M3, MiniMax-M3[1m] → MiniMax M3 (1M), abab-6.5s-chat → ABAB 6.5s Chat.

Works with mmcode or any launcher that sets ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN.

Balance Display (GLM)

When using GLM as the backend (ANTHROPIC_BASE_URL set to https://open.bigmodel.cn/api/anthropic or https://api.z.ai/api/anthropic), cc-hud automatically shows your account balance — zero configuration required.

[GLM 5.2] ████▏░░░░░ 41% (1M) │ ¥88.50

Balance is cached locally for 5 minutes. On cache miss, cc-hud fetches the latest balance from GLM's account API. Works with glmcode, ZCode, or any launcher that sets ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN.

Model names are beautified automatically: glm-5.2 → GLM 5.2, glm-5.2[1m] → GLM 5.2 (1M), glm-5-turbo → GLM 5 Turbo, glm-4.5-air → GLM 4.5 Air.

Development

npm run build      # compile
npm test           # 57 tests

Star History

_{MIT License © Water}