claude-dashboard  by uppinote20

AI development environment status line

Created 3 months ago
307 stars

Top 87.4% on SourcePulse

GitHubView on GitHub
Project Summary

A comprehensive status line plugin for Claude Code, claude-dashboard addresses the need for real-time monitoring of AI usage, API limits, and costs directly within the IDE. It targets developers and power users of Claude Code who interact with multiple AI models and services, providing immediate visibility into session metrics, rate limits, and financial expenditure, thereby enhancing productivity and cost awareness.

How It Works

This plugin injects a highly customizable status line into Claude Code, leveraging a modular widget system. It aggregates data from various AI providers, including z.ai/ZHIPU, Codex, and Gemini, automatically detecting their presence. Users can configure dozens of widgets to display specific information such as model name, context usage progress, session cost, API rate limit countdowns, project details, and token analytics. The system supports multiple display modes (compact, normal, detailed) and offers extensive customization through a JSON configuration file or intuitive preset shortcuts.

Quick Start & Requirements

  • Primary install: Via Claude Code Plugin Marketplace: /plugin marketplace add uppinote20/claude-dashboard followed by /plugin install claude-dashboard. Manual installation involves cloning the repository to ~/.claude/plugins/claude-dashboard and running /claude-dashboard:setup.
  • Prerequisites: Claude Code v1.0.80+ and Node.js 18+.
  • Links: Official documentation is integrated within the README.

Highlighted Details

  • Extensive modular widget system covering core metrics, rate limits, session details, activity, analytics, and multi-CLI usage.
  • Multi-provider support for z.ai/ZHIPU, Codex, and Gemini, with auto-detection.
  • Configurable display modes (compact, normal, detailed) and customizable layouts via JSON or preset shortcuts (e.g., "preset": "MC$R|BDO").
  • Theming support with options like Catppuccin, Dracula, Nord, and TokyoNight.
  • Integrated budget tracking with visual alerts for daily spending thresholds.

Maintenance & Community

No specific details regarding notable contributors, sponsorships, or community channels (like Discord/Slack) were found in the provided README.

Licensing & Compatibility

The project is released under the MIT License, which generally permits commercial use and integration into closed-source projects without significant restrictions.

Limitations & Caveats

The "depletionTime" widget provides an approximation based on the assumption that all utilization stems from the current session. Certain widgets are designed to auto-hide if corresponding authentication files for other CLIs are not detected. The plugin is specific to the Claude Code IDE environment.

Health Check
Last Commit

3 days ago

Responsiveness

Inactive

Pull Requests (30d)
10
Issues (30d)
8
Star History
82 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.