claude-analyst

🥈Silver

Claude Analyst is a macOS menu bar app that monitors Claude Code usage in real-time. It tracks token consumption, costs, and usage patterns, helping users optimize their AI interactions without leaving their workflow.

1600Updated 1mo ago

Intermediate30min to implementautomation

Saves ~15 min per use

Quick InstallView Source

git clone https://github.com/onmyway133/claude-analyst.git

Works with:

Claude

Overview

About This Skill

Claude Analyst is a native macOS menu bar application designed for developers and teams using Claude Code to monitor their AI usage in real-time. The app tracks token consumption, daily costs, and usage patterns across projects and sessions, helping users understand and optimize their Claude API spending without interrupting their workflow. It provides multiple views—including a dashboard with visual usage rings, detailed analytics with interactive charts, project-level breakdowns, and a chronological activity timeline—all updated live as you work. All usage data is stored locally on your machine with no external data transmission, ensuring your information stays private. Installation requires macOS 14.0 or later and the ccusage command-line tool, making it a lightweight addition to your development environment.

How to Use

Install the ccusage CLI tool globally with npm, then download and move Claude Analyst to your Applications folder. Launch the app—it will appear in your macOS menu bar with a 🤖 icon. Configure your Claude plan and display preferences in Settings, and optionally enable auto-launch at login.

Use Cases

Monitor daily token consumption and costs for Claude Code sessions in real-time

Identify which projects consume the most tokens for cost allocation across teams

Analyze usage trends and peak activity times to optimize when you use Claude

Track session-level details and efficiency metrics to understand your Claude usage patterns

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/onmyway133/claude-analyst

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

Analyze my Claude Code usage data from [DATE RANGE] and identify patterns in my interactions. Provide insights on how I can optimize my workflow to reduce costs while maintaining productivity. Focus on [SPECIFIC GOALS] like reducing unnecessary prompts or improving response efficiency.

Example Output

# Claude Code Usage Analysis

## Usage Summary
- **Total Tokens Used**: 12,450
- **Cost**: $18.68
- **Average Tokens per Interaction**: 156
- **Peak Usage Time**: 2:00 PM - 4:00 PM

## Key Insights
- **High Token Consumption**: Your interactions related to [COMPANY] data analysis in the [INDUSTRY] sector are consuming significantly more tokens than other topics.
- **Inefficient Prompts**: Several prompts could be optimized for brevity without losing context. For example, your prompt on [DATE] used 240 tokens but could be reduced to 120 tokens with minimal impact on the response quality.
- **Cost-Saving Opportunity**: By refining your prompts and reducing unnecessary interactions, you could save up to 20% on your monthly Claude Code costs.

## Recommendations
1. **Refine Prompts**: Focus on making your prompts more concise and specific to reduce token usage.
2. **Schedule Interactions**: Consider scheduling high-token interactions during off-peak hours to take advantage of lower usage rates.
3. **Review Usage Patterns**: Regularly review your usage patterns to identify and address any inefficiencies.