CCSeva is a macOS menu bar application designed for real-time tracking of Claude Code usage. It provides users with insights into token consumption, associated costs, and usage patterns through an elegant interface, benefiting developers and power users of Claude Code who need to monitor their resource utilization.

How It Works

CCSeva leverages Electron, React, and TypeScript to create a desktop application that integrates with the macOS menu bar. It automatically detects Claude Code configurations from the ~/.claude directory and polls usage data every 30 seconds. The app visualizes this data using charts and color-coded indicators, offering smart notifications and cost estimations.

Quick Start & Requirements

• Installation: Download the latest release DMG from GitHub Releases.
• Prerequisites: macOS 10.15+, Claude Code CLI installed and configured. Node.js 18+ is required for building from source.
• Build from Source: git clone https://github.com/Iamshankhadeep/ccseva.git && cd ccseva && npm install && npm run build

Highlighted Details

• Real-time token usage tracking with 30-second updates.
• Menu bar integration with percentage indicator and color-coded status.
• Auto-detection of Claude Code plans (Pro, Max5, Max20, Custom).
• 7-day usage charts, model breakdowns, and daily cost estimates.

Maintenance & Community

This is an unofficial tool. Further community or maintenance details are not specified in the README.

Licensing & Compatibility

• License: MIT License.
• Compatibility: Compatible with macOS. Requires a valid Claude Code installation.

Limitations & Caveats

The tool is unofficial and relies on the Claude Code CLI configuration. Node.js 18+ is a requirement for building from source, which may be a barrier for users not involved in development.