claude-dashboard

claude-dashboard

Comprehensive status line plugin for Claude Code with context usage, API rate limits, cost tracking, and modular widget system.

Demo

Installation

Requirements: Claude Code v1.0.80+ / Node.js 18+

From Plugin Marketplace

/plugin marketplace add uppinote20/claude-dashboard
/plugin install claude-dashboard
/claude-dashboard:setup

Manual Installation

git clone https://github.com/uppinote20/claude-dashboard.git ~/.claude/plugins/claude-dashboard
/claude-dashboard:setup

Display Modes

Compact (1 line) - Default:

Model, context progress bar, cost, rate limits (5h/7d/7d-Sonnet) or z.ai usage (mutually exclusive by provider)

Normal (2 lines):

Adds project info, session ID, session duration, burn rate, todo progress

Detailed (6 lines):

Adds depletion time, config counts, tool/agent status, cache hit, performance badge, token breakdown, forecast, budget, Codex/Gemini usage

Multi-provider support: z.ai/ZHIPU, Codex, Gemini auto-detected when installed.

Widgets

Category	Widget	Description
Core	model	Model name with emoji, effort level for Opus/Sonnet (H/M/L), fast mode for Opus (↯)
	context	Progress bar, percentage, tokens (🟢 0-50% / 🟡 51-80% / 🔴 81-100%)
	cost	Session cost in USD
	projectInfo	Directory + git branch (clickable OSC8 link) + ahead/behind (↑↓), subpath from project_dir, worktree indicator (🌳)
Rate Limits	rateLimit5h	5-hour rate limit with reset countdown
	rateLimit7d	7-day rate limit (Max only)
	rateLimit7dSonnet	7-day Sonnet limit (Max only)
Session	sessionId	Session ID (short 8-char)
	sessionIdFull	Session ID (full UUID)
	sessionName	Session name from /rename command
	sessionDuration	Session duration
	lastPrompt	Last user prompt with timestamp
	configCounts	CLAUDE.md, AGENTS.md, rules, MCPs, hooks, +Dirs
Activity	toolActivity	Running/completed tools with targets (e.g., Read(app.ts))
	agentStatus	Subagent progress
	todoProgress	Todo completion rate
Analytics	burnRate	Token consumption per minute
	cacheHit	Cache hit rate percentage
	depletionTime	Estimated time to rate limit (approx)¹
Multi-CLI	codexUsage	OpenAI Codex CLI usage (auto-hide if not installed)²
	geminiUsage	Google Gemini CLI - current model (auto-hide if not installed)³
	geminiUsageAll	Google Gemini CLI - all models (auto-hide if not installed)³
	zaiUsage	z.ai/ZHIPU usage (auto-hide if not using z.ai)⁴
Insights	tokenBreakdown	Input/output/cache write/read token breakdown
	performance	Composite efficiency badge (cache hit + output ratio)
	forecast	Estimated hourly cost based on session rate
	budget	Daily spending vs configured budget limit⁵
	tokenSpeed	Output token generation speed (tok/s)
	todayCost	Total spending across all sessions today
Info	linesChanged	Uncommitted lines added/removed, including untracked files (+N -N)
	outputStyle	Current output style (hidden when "default")
	version	Claude Code version display
	vimMode	Vim mode (NORMAL/INSERT), auto-hides when vim disabled
	apiDuration	API time as % of total session time

¹ Assumes all utilization came from this session; improves as session runs longer. ² Auto-hides if ~/.codex/auth.json not found. ³ Auto-hides if ~/.gemini/oauth_creds.json not found. ⁴ Auto-hides if not detected via ANTHROPIC_BASE_URL. ⁵ Requires "dailyBudget" in config.

i18n: English and Korean supported (auto-detect or set via setup).

Configuration

# Preset modes
/claude-dashboard:setup compact             # 1 line (default)
/claude-dashboard:setup normal en pro       # 2 lines, English, Pro plan
/claude-dashboard:setup detailed ko max     # 6 lines, Korean, Max plan

# Custom mode: control widget order and line composition
# Format: "widget1,widget2,...|widget3,widget4,..." (| separates lines)
/claude-dashboard:setup custom auto max "model,context,cost|projectInfo,todoProgress"

Plan differences:

Feature	Max	Pro
5h rate limit + countdown	✅	✅
7d all models	✅	❌

Advanced Configuration

Interactive Mode: Run /claude-dashboard:setup without arguments. Best for preset selection; for full widget control, use Direct Mode or edit the JSON file directly.