Iamshankhadeep/ccseva

A beautiful macOS menu bar app for tracking your Claude Code usage in real-time.

What it solves

CCSeva is a lightweight macOS menu bar application designed to help users of Claude Code track their token consumption, costs, and server-side usage limits in real-time. It eliminates the need to manually check limits, providing immediate visibility into 5-hour session blocks and weekly utilization.

How it works

The app is built natively in Swift and SwiftUI, running as a menu-bar-only application. It parses the local ~/.claude transcripts (JSONL files) directly to calculate usage. It also reads Claude Code's OAuth usage endpoint to provide "server-truth" limit gauges, with a local estimation fallback if the endpoint is unavailable.

Who it’s for

Developers and power users of Claude Code on macOS who want to monitor their API costs and token burn rate without leaving their terminal or using heavy runtime dependencies.

Highlights

  • Real-time Menu Bar Tracking: Displays usage percentage with color-coded status directly in the macOS menu bar.
  • Server-Truth Gauges: Tracks 5-hour and weekly utilization, including usage from other devices, with predicted cutoff times.
  • Native Performance: A ~3 MB app bundle with zero runtime dependencies (no Electron or Node.js).
  • Detailed Analytics: Provides per-model and per-project cost breakdowns using Swift Charts.
  • Native Notifications: Alerts users at 70% and 90% usage thresholds.
  • Optional Sync: Opt-in synchronization with claudecode.directory for a private usage dashboard.

Related

  • Project
    Artzainnn/ClaudeUsageBar

    A macOS menu bar application that tracks Claude.ai session and weekly usage limits in real-time using session cookies.

  • Dispatch
    claude-quota: macOS Menu Bar Gauges for Claude Code Usage

    claude-quota is a SwiftBar plugin for macOS that provides real-time visual gauges in the menu bar to track Claude Code quota utilization across multiple accounts.

  • Project
    richhickson/claudecodeusage

    A lightweight macOS menubar app that tracks Claude Code usage limits and provides notifications when AI agent sessions need user attention.

  • Project
    leeguooooo/claude-code-usage-bar

    A real-time status bar for Claude Code and the Claude macOS desktop app that displays rate limits, context window usage, and prompt-cache freshness.

  • Project
    f-is-h/Usage4Claude

    Usage4Claude is a native macOS menu‑bar app that monitors Anthropic Claude (and optional OpenAI Codex) subscription quotas in real time. It supports all Claude products, multiple accounts, adaptive refresh, colour‑coded usage rings, notifications, and stores credentials securely in the macOS Keychain. Install via a pre‑built DMG or build from source with Swift/SwiftUI.