https://github.com/androidZzT/cc-statistics
AI Coding stats dashboard — track costs, tokens, and efficiency across Claude Code / Gemini CLI / Codex / Cursor
https://github.com/androidZzT/cc-statistics
ai-coding claude-code cli cost-estimation developer-tools gemini-cli macos-app menu-bar-app python swiftui token-tracking token-usage usage-tracker
Last synced: 7 days ago
JSON representation
AI Coding stats dashboard — track costs, tokens, and efficiency across Claude Code / Gemini CLI / Codex / Cursor
- Host: GitHub
- URL: https://github.com/androidZzT/cc-statistics
- Owner: androidZzT
- License: mit
- Created: 2026-03-17T09:02:43.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-04-12T04:33:43.000Z (15 days ago)
- Last Synced: 2026-04-12T06:20:50.298Z (15 days ago)
- Topics: ai-coding, claude-code, cli, cost-estimation, developer-tools, gemini-cli, macos-app, menu-bar-app, python, swiftui, token-tracking, token-usage, usage-tracker
- Language: Swift
- Size: 13 MB
- Stars: 58
- Watchers: 0
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-claude-code-toolkit - cc-statistics - in-one Claude Code stats: CLI + Web + native macOS SwiftUI panel. Token costs, code changes by language, efficiency scoring, weekly reports. Supports Codex and Cursor too | (Ecosystem / Quick Setup with cc-safe-setup)
README
cc-statistics
The only AI coding tracker that unifies Claude Code, Gemini CLI, Codex CLI, and Cursor — in one native macOS app.
Track every token, cost, and session across all your AI tools. 100% local. Zero dependencies.
Why? •
Features •
Screenshots •
Quick Start •
CLI •
中文
---
## 🤔 Why cc-statistics?
You're using multiple AI coding tools. But do you actually know:
- 💸 **What your combined spend is** across Claude Code, Gemini CLI, Codex, and Cursor?
- 🔧 **Which MCP tools are being called most** — and whether they're worth the tokens?
- ⏱️ **How much time Claude is actually working** versus waiting for you?
- 📈 **Which projects are consuming the most** — and across which models?
Most tools only answer this for Claude Code. cc-statistics answers it for all four.
### How does it compare?
| | cc-statistics | CCDash | claude-usage | ccflare |
|---|:---:|:---:|:---:|:---:|
| **Claude Code** | ✅ | ✅ | ✅ | ✅ |
| **Gemini CLI** | ✅ | ❌ | ❌ | ❌ |
| **Codex CLI** | ✅ | ❌ | ❌ | ❌ |
| **Cursor** | ✅ | ❌ | ❌ | ❌ |
| **Native macOS App** | ✅ | ❌ | ❌ | ❌ |
| **Pixel-Art Mascot (Clawd)** | ✅ | ❌ | ❌ | ❌ |
| **Session Search & Resume** | ✅ | ✅ | ❌ | ❌ |
| **Weekly / Monthly Reports** | ✅ | ✅ | ❌ | ❌ |
| **Webhook** (Slack / Feishu / DingTalk) | ✅ | ✅ Slack/Discord | ❌ | ❌ |
| **Tool Call Analytics** | ✅ | ✅ | ❌ | ❌ |
| **Code Changes by Language** | ✅ | ❌ | ❌ | ❌ |
| **AI vs User Time** | ✅ | ❌ | ❌ | ❌ |
| **Usage Alerts** | ✅ | ✅ | ❌ | ❌ |
| **Usage Quota Predictor** | ✅ | ✅ | ❌ | ❌ |
| **Share Session Messages** | ✅ | ❌ | ❌ | ❌ |
| **Web Dashboard** | ✅ | ✅ | ✅ | ✅ |
| **CLI Tool** | ✅ | ✅ | ❌ | ✅ |
| **Zero Dependencies** | ✅ | ✅ | ❌ | ❌ |
| Cache Efficiency Grade | ⏳ planned | ✅ | ❌ | ❌ |
| Live Stream | ⏳ planned | ✅ | ❌ | ❌ |
> cc-statistics is a community project, not affiliated with Anthropic, Google, or OpenAI.
---
## 🚀 Features
### 🌐 4-Platform Unified View
> Claude Code · Gemini CLI · Codex CLI · Cursor — switch between platforms or aggregate all four into a single report. Each source is read entirely from local files; no API keys, no accounts, no network requests.
### 🖥️ Native macOS Menu Bar App
> Pre-built SwiftUI binary — launch with `cc-stats-app` and it lives in your menu bar permanently. Shows Claude logo + today's token count + estimated cost at a glance. Turns **red** when you hit your daily usage quota. Right-click to switch display modes. Global hotkey `Cmd+Shift+C` opens the full dashboard from anywhere.
### 🐾 Clawd — Pixel-Art Status Bar Mascot
> A pixel-art Clawd mascot reacts to Claude Code's agent state in real time: idle, thinking, typing, happy, sleeping, and error — each with its own animated sprite. Built on [clawd-on-desk](https://github.com/rullerzhou-afk/clawd-on-desk) hook integration.
### 📊 Usage Quota Predictor
> Real-time prediction of when you'll hit your usage quota based on current burn rate. Displays estimated time remaining, projected reset time, and risk level — so you can pace your usage and avoid unexpected throttling.
### 🔍 Session Search & Resume
> Search your entire session history by keyword across all platforms. Results show timestamps and a ready-to-run resume command — one copy-paste and you're back in context:
> ```bash
> claude --resume
> ```
### 💬 Share Session Messages
> Export and share individual session conversations as clean, formatted text — useful for documenting AI-assisted work, sharing context with teammates, or archiving important sessions.
### 📊 Multi-Dimensional Analytics
> Instructions count · Tool calls Top 10 (Skill and MCP tools broken out by name) · AI processing time vs user active time · Code changes by language (via `git log --numstat`) · Token breakdown by model · Cost estimation with built-in pricing for Opus / Sonnet / Haiku / Gemini 2.5 Pro / Flash / GPT-4o
### 🔔 Usage Alerts
> Set daily and weekly cost limits. When you're over threshold, the macOS menu bar icon turns red and a native system notification fires — respecting your Focus modes, no app in foreground required.
### 📋 Weekly & Monthly Reports
> Auto-generate Markdown summaries for any period: total tokens, cost by model, most active projects, top tool calls, code changes by language. Push directly to your team channel:
> ```bash
> cc-stats --report week
> cc-stats --notify https://hooks.slack.com/services/xxx
> ```
> Slack, Feishu, and DingTalk webhooks all supported.
### ⚡ Project Comparison
> See which projects are consuming the most resources side by side:
> ```bash
> cc-stats --compare --since 1w
> ```
### 🌐 Web Dashboard
> Browser-based dark-themed dashboard for all platforms — useful on Linux/Windows or when you want a larger view than the menu bar panel.
### 🔒 100% Local & Zero Dependencies
> All data is read from local files. Nothing is sent over the network. Pure Python standard library — no `pip install`, no npm, no Docker.
---
## 🖼️ Screenshots
🖥️ macOS App — Dark Mode
🖥️ macOS App — Light Mode
📊 Usage Quota Predictor
🔴 Max Usage Reached
🔍 Session List
🔧 Tool Call Analytics
⚡ Skill / MCP Analytics
💬 Share Session Messages
🌐 4-Platform Unified View
⚙️ Settings
🔔 Notifications
🌐 Web Dashboard
### CLI Demo
---
## ⚡ Quick Start
### Prerequisites
- Python 3.8+
- At least one of: Claude Code CLI, Gemini CLI, Codex CLI, or Cursor installed and used
### 3 steps
```bash
# 1. Install
uv tool install cc-statistics # or: pipx install cc-statistics
# 2. Run your first report (all platforms, last 7 days)
cc-stats --all --since 7d
# 3. Launch macOS menu bar app (macOS only)
cc-stats-app
```
That's it. No configuration file needed.
**Alternative install methods:**
```bash
# pipx
pipx install cc-statistics
# Homebrew (macOS / Linux)
brew install androidZzT/tap/cc-statistics
```
---
## 📖 CLI Reference
```bash
cc-stats # Analyze current directory sessions
cc-stats --list # List all detected projects (all platforms)
cc-stats --all --since 3d # Last 3 days, all projects, all platforms
cc-stats --all --since 1w # Last week
cc-stats myproject --last 3 # Last 3 sessions for a specific project
cc-stats --report week # Generate weekly Markdown report
cc-stats --report month # Generate monthly Markdown report
cc-stats --compare --since 1w # Side-by-side project comparison
cc-stats --notify # Push report to Slack / Feishu / DingTalk webhook
cc-stats-web # Open web dashboard in browser
cc-stats-app # Launch macOS menu bar app
```
---
## 🗂️ Data Sources
All data is read from local files. Nothing is sent over the network.
| Source | Local path |
|--------|-----------|
| Claude Code | `~/.claude/projects//.jsonl` |
| Gemini CLI | `~/.gemini/tmp//chats/.json` |
| Codex CLI | `~/.codex/sessions/*.jsonl` |
| Cursor | `~/Library/Application Support/Cursor/User/globalStorage/state.vscdb` |
| Git Changes | `git log --numstat` in project directory |
---
## Acknowledgments
Status bar Clawd animation sprites from [clawd-on-desk](https://github.com/rullerzhou-afk/clawd-on-desk) — an Electron desktop pet that senses AI coding agent state via hooks and plays pixel-art animations.
---
## Support
If cc-statistics saves you money on your AI coding bills, consider [sponsoring](https://github.com/sponsors/androidZzT) the project.