Why CC-HUD?

The Problem

Claude Code's native installer bundles Bun, which has a known memory allocator bug on Windows (oven-sh/bun#25082), causing frequent pas panic crashes. Statusline plugins like jarrodwatts/claude-hud run on every tick, amplifying memory pressure and making crashes far more likely.

The Solution

CC-HUD is a crash-free alternative — pure Node.js, zero dependencies, stateless per-call, ~60ms execution, 2s hard timeout. Designed to keep your status bar running without taking Claude Code down.

为什么做 CC-HUD？

问题

Claude Code 原生安装器内嵌 Bun，在 Windows 上存在已知内存分配器 bug（oven-sh/bun#25082），频繁触发 pas panic 崩溃。而 jarrodwatts/claude-hud 等状态栏插件每次 tick 都会执行，加剧内存压力，使崩溃更加频繁。

解决方案

CC-HUD 是不会崩溃的替代方案 — 纯 Node.js、零依赖、无状态调用、~60ms 执行、2s 硬超时。让状态栏稳定运行，不拖垮 Claude Code。

[!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.

Development

npm run build      # compile
npm test           # 32 tests

Star History