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.
uppinote20