Claude Code usage

Cctray

macOS menu bar app for monitoring Claude Code usage

Install

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

From the README

CCTray

A macOS menu bar application that monitors Anthropic's Claude API usage in real-time. It provides instant visibility into your AI development costs and usage patterns, inspired by the excellent command-line tool ccowl.
✨ Fun Fact: This application was developed almost exclusively using Anthropic's Claude.

šŸš€ Features

- Dynamic Menu Bar Icon: The app icon provides at-a-glance insights with:
    - Color-Coded States: Green (normal), Yellow (warning), and Red (critical) based on your usage thresholds.
    - Pulsing Animation: A subtle pulse warns you when you're approaching limits.
    - Mini Progress Arc: A circular progress bar around the icon shows token usage percentage.
- Rich Data Visualization: The main view presents data visually for quick comprehension:
    - Progress Bars: See your token usage against limits.
    - Trend Indicators: Small arrows (ā†—ļø ā†˜ļø ā†”ļø) show if your usage is increasing, decreasing, or stable.
    - Sparkline Charts: Mini-graphs display recent usage patterns.
    - Color-Coded Metrics: Key numbers are colored based on semantic thresholds for instant understanding.
- Quick Actions: Access common tasks directly from the main menu:
    - Copy usage data to the clipboard.
    - Toggle critical notifications on/off.
    - Keyboard shortcuts for power users.
- Real-time Monitoring: Live tracking of Claude API usage via the ccusage CLI.
- Smart Rotating Display: Cycles through key metrics like cost, burn rate, and remaining session time right in your menu bar.
- Deep Customization: A comprehensive four-tab preferences window lets you control everything from refresh rates to visual thresholds.
- Robust & Efficient: Features intelligent error handling, automatic Node.js path detection, and is optimized for minimal resource usage.

šŸ“±ā€¦
Read the full README on GitHub

Details

Language
Swift
License
MIT
Last updated
25 July 2025
Topics
ccusageclaudeclaude-codeclaudecode

FAQ

What is Cctray?

macOS menu bar app for monitoring Claude Code usage It is a usage for Claude Code, from goniszewski/cctray on GitHub.

How do I install Cctray?

Clone goniszewski/cctray from GitHub and follow the setup steps in its README.

Is Cctray popular?

goniszewski/cctray has 41 GitHub stars and 2 forks. It was last updated on 25 July 2025.

More usage & cost trackers

Browse the most popular Claude Code mods, all usage & cost trackers, or the skills and MCP server directories.