cctray

🥈Silver

macOS menu bar app that monitors Anthropic Claude API usage in real-time with color-coded alerts, progress visualization, and cost tracking for AI developers.

4130Updated 2mo ago

Intermediate30min to implementautomation

Saves ~15 min per use

Quick InstallView Source

git clone https://github.com/goniszewski/cctray.git

Works with:

Claude

Overview

About This Skill

CCTray is a macOS menu bar application that provides real-time visibility into Anthropic's Claude API usage and costs. It displays dynamic, color-coded metrics directly in your menu bar with green (normal), yellow (warning), and red (critical) states based on usage thresholds. The app offers rich data visualization including progress bars, trend indicators, sparkline charts, and a rotating display of key metrics like cost, burn rate, and remaining session time. Users can customize refresh rates, visual thresholds, and notification preferences through a comprehensive four-tab preferences window. CCTray requires macOS 13.0+, Node.js, and the ccusage CLI tool, making it ideal for developers actively using Claude API who need instant insights into their AI development spending.

How to Use

Install Node.js and the ccusage CLI tool globally with `npm install -g ccusage`. Download CCTray.dmg from the Releases page, drag CCTray.app to Applications, and launch it. Click the menu bar icon to view usage details and access Preferences to customize refresh rates, display metrics, and visual thresholds. If you encounter errors, manually specify your Node.js or ccusage paths in Preferences → Advanced.

Use Cases

Monitor Claude API costs and token usage in real-time while developing

Set up visual alerts when approaching budget limits or high burn rates

Track API burn rate trends to optimize Claude usage patterns

Quick-copy usage data to clipboard for reporting or analysis

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/goniszewski/cctray

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Create a cctray macOS menu bar app that monitors my usage of Claude Code. The app should display real-time metrics like tokens used, API calls made, and cost incurred. Include a 7-day usage history graph and a daily limit alert feature. Use [COMPANY] branding colors and ensure it's lightweight and efficient.

Example Output

# cctray - Claude Code Usage Monitor

## Current Session
- **Tokens Used**: 1,248
- **API Calls**: 42
- **Estimated Cost**: $0.18

## 7-Day Usage History
```
Day       Tokens   Calls   Cost
Mon       850      30      $0.12
Tue       1,248    42      $0.18
Wed       987      38      $0.14
Thu       1,500    50      $0.22
Fri       750      25      $0.10
Sat       1,100    40      $0.16
Sun       600      20      $0.09
```

## Alerts
- **Daily Limit Alert**: 80% of your daily limit of 10,000 tokens has been reached.

## Settings
- **Branding Colors**: #2A5CAA, #FFFFFF
- **Lightweight Mode**: Enabled
- **Auto-Refresh**: Every 5 minutes