Skip to content

feat: add balance-hud v2.0.0 — HUD statusline + API balance monitoring#4

Open
BFRKQSB7 wants to merge 2 commits into
kossakovsky:mainfrom
BFRKQSB7:main
Open

feat: add balance-hud v2.0.0 — HUD statusline + API balance monitoring#4
BFRKQSB7 wants to merge 2 commits into
kossakovsky:mainfrom
BFRKQSB7:main

Conversation

@BFRKQSB7

@BFRKQSB7 BFRKQSB7 commented Jul 4, 2026

Copy link
Copy Markdown

Description

Add balance-hud — a full-featured Claude Code HUD statusline plugin with real-time API balance monitoring.

Features

  • Context health — color-coded progress bar (green/yellow/red) with percentage
  • Tool activity — running/completed tools display
  • Agent tracking — sub-agent status
  • Todo progress — task completion display
  • Git status — branch name, dirty state
  • API balance monitoring — DeepSeek/OpenAI/Anthropic balance with 15s auto-refresh daemon
  • Low-balance warnings — configurable threshold, yellow/red alerts
  • Multi-language — English + Chinese (zh-Hans)
  • Interactive setup/balance-hud:setup auto-detects platform, shell, runtime

Attribution

HUD rendering engine adapted from claude-hud by Jarrod Watts (MIT License). See NOTICE.md for detailed third-party code listing.

Plugin Structure

plugins/balance-hud/
├── .claude-plugin/plugin.json   # Plugin manifest
├── commands/                     # /balance-hud:setup, /balance-hud:configure
├── hooks/hooks.json              # SessionStart auto-refresh daemon
├── dist/                         # HUD engine (compiled JS)
├── scripts/                      # Balance daemon scripts
├── README.md, LICENSE, NOTICE.md

CI Checklist

  • plugin.json with name (kebab-case), version, description
  • README.md with installation and usage docs
  • Marketplace entry with source: ./plugins/balance-hud
  • Valid category (productivity), tags, keywords
  • No duplicate plugin name
  • License (MIT, with original claude-hud copyright preserved)
  • No hardcoded secrets or API keys

🤖 Generated with Claude Code
Co-Authored-By: Claude noreply@anthropic.com

BFRKQSB7 and others added 2 commits July 5, 2026 00:30
Real-time Claude Code HUD statusline with:
- Context health progress bar with color-coded warnings
- Tool activity, agent tracking, todo progress
- Git branch/status display
- DeepSeek/OpenAI/Anthropic API balance monitoring (auto-refresh daemon)
- Low-balance warnings with configurable thresholds
- Multi-language support (English, Chinese)
- Interactive setup command (/balance-hud:setup)

Based on claude-hud by Jarrod Watts (MIT License).

Co-Authored-By: Claude <noreply@anthropic.com>
balance-hud is a Node.js statusline plugin. dist/ contains the compiled
runtime engine — it is NOT a build artifact in the traditional sense.
The .js and .js.map files are the distributable plugin payload.

Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant