https://github.com/onmyway133/claude-analyst
Claude Code usage analyzer
https://github.com/onmyway133/claude-analyst
analysis claude-code sonnet usage
Last synced: 4 months ago
JSON representation
Claude Code usage analyzer
- Host: GitHub
- URL: https://github.com/onmyway133/claude-analyst
- Owner: onmyway133
- Created: 2025-12-20T06:40:29.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2026-01-07T08:38:36.000Z (6 months ago)
- Last Synced: 2026-01-13T19:57:14.775Z (6 months ago)
- Topics: analysis, claude-code, sonnet, usage
- Language: Swift
- Homepage: https://onmyway133.com/
- Size: 2.53 MB
- Stars: 10
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-swift-macos-apps - Claude Analyst - analyst?style=flat&label=" /> <img align="bottom" height="13" src="https://img.shields.io/github/last-commit/onmyway133/claude-analyst?style=flat&label=" /> - Menu bar monitor for Claude Code token consumption, costs, and usage patterns in real-time. (AI Usage/Status)
README
# Claude Analyst
A native macOS menu bar app that helps you monitor your Claude Code usage in real-time. Keep track of your token consumption, costs, and usage patterns without leaving your workflow.
## What is Claude Analyst?
This app lives in your macOS menu bar and provides instant visibility into your Claude Code usage. Whether you're a developer using Claude for coding assistance or managing multiple projects, this tool helps you stay informed about your usage and costs.
## Features
### 📊 Dashboard View
Get a quick overview of your current usage status with an intuitive visual interface.
- **Usage Ring**: Visual gauge showing your token consumption percentage
- **Quick Stats**: At-a-glance cards for tokens used, cost today, remaining tokens, and reset time
- **Real-time Updates**: Live monitoring of your Claude Code usage
### 📈 Analytics View
Dive deeper into your usage patterns with comprehensive analytics and trends.
- **Interactive Charts**: Visualize your usage over different time periods (7, 14, 30, 90 days)
- **Multiple Chart Types**: Switch between tokens, cost, and session analytics
- **Usage Trends**: Peak usage times, most active days, and session insights
- **Summary Statistics**: Total tokens, costs, daily averages, and efficiency metrics
### 📁 Projects View
Monitor usage across different projects and workspaces for better cost allocation.
- **Project Rankings**: See which projects consume the most resources
- **Usage Distribution**: Visual breakdown of token usage per project
- **Detailed Metrics**: Tokens, costs, sessions, and efficiency per project
- **Project Analytics**: Deep dive into individual project statistics
### 📝 Activity View
Get a detailed timeline of your Claude interactions organized by day.
- **Chronological Timeline**: See all your Claude sessions organized by day
- **Session Details**: Token usage, costs, and timing for each interaction
- **Smart Filtering**: Filter by date ranges and search through activities
- **Usage Insights**: Understand when and how you use Claude throughout the day
### ⚙️ Settings View
Customize the app to match your preferences and workflow.
- **Plan Configuration**: Set your Claude plan (Pro, Max5, Max20, or custom limits)
- **Menu Bar Display**: Choose what to show in the menu bar (percentage, tokens, or cost)
- **Monitoring Options**: Configure refresh intervals and auto-start behavior
- **Launch at Login**: Automatically start the app when you log in
- **Data Management**: Control data retention and clear history
## Installation & Setup
### Prerequisites
First, install the required command-line tool:
```bash
npm install -g ccusage
```
### Installation
1. Download the latest release from [Releases](../../releases)
2. Move the app to your Applications folder
3. Launch Claude Analyst
4. The app will appear in your menu bar with a 🤖 icon
### First Launch
- The app will automatically detect your Claude plan or you can set it manually in Settings
- Choose your preferred menu bar display format (percentage, tokens, or cost)
- Optionally enable "Launch at Login" to start automatically
## Menu Bar Display
The app shows your current usage status directly in the menu bar:
- **🤖 75%** - Percentage mode (default)
- **🤖 5250** - Tokens used mode
- **🤖 $0.25** - Cost mode
Click the menu bar icon to open the full analytics interface.
## Requirements
- **macOS 14.0+** (Sonoma or later)
- **Node.js** (for ccusage CLI tool)
- **Active Claude subscription** (Pro, Max5, or Max20)
## Privacy & Security
- **Local Data**: All usage information stays on your machine
- **Privacy First**: No data is sent to external servers
- **Secure Storage**: Usage history is stored locally for analytics
## Developer
Created by **[@onmyway133](https://github.com/onmyway133)**
- 🌐 Website: [onmyway133.com](https://onmyway133.com)
- 💻 GitHub: [github.com/onmyway133](https://github.com/onmyway133)
## License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.