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/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 (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) |
| 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 |
¹ 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. ⁶ Peak = weekdays 5-11 AM PT; shows countdown to next transition. ⁷ Uses tagPatterns config (default ["v*"]); auto-hides when no pattern matches a reachable tag.
i18n: English and Korean supported (auto-detect or set via setup).
Configuration
