claude-dashboard

claude-dashboard

Comprehensive status line plugin for Claude Code — unified usage monitoring across Claude, Codex, Gemini, and z.ai CLIs, with context, rate limits, cost tracking, and a 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) 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/Fable (MAX/X/H/M/L), fast mode for Opus (↯)
	context	Progress bar, percentage, tokens (🟢 0-50% / 🟡 51-80% / 🔴 81-100%)
	contextBar	Progress bar only (sub-widget of context)
	contextPercentage	Percentage only (sub-widget of context)
	contextUsage	Token count only, e.g. 42K/200K (sub-widget of context)
	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 (Pro and Max)
	rateLimit7dSonnet	7-day Sonnet limit (Max only) — deprecated ~2026-06: Anthropic merged it into the unified weekly bucket at the Sonnet 5 launch, so the API returns null and the widget stays hidden until/unless the field returns
	rateLimit7dFable	7-day Fable 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
Status	peakHours	Peak hours indicator with countdown (based on PeakClaude)⁶
	tagStatus	Commits ahead of matched git tags (default pattern v*, customize via tagPatterns)⁷
	slashCommand	Active slash command for the current turn (🎯), cleared by next plain-text message
	agentMode	Session agent identity: 👤 custom agent (via /agent <name>) or 🤖 subagent type
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