🎯 Claude Code Costs Analyzer

Modern, interactive cost analysis tool for your Claude Code conversations

Analyze your Claude Code conversation costs with beautiful, interactive visualizations and detailed insights. Get a comprehensive view of your AI usage patterns with dark/light mode support and sortable data tables.

---

✨ Features

- 🎨 Modern UI Design - Beautiful dark/light mode interface with gradient backgrounds
- 📊 Interactive Charts - Dynamic cost visualization with Chart.js
- 📋 Sortable Tables - Click any column header to sort your conversation data
- 🌙 Dark Mode - Default dark theme with toggle option
- 🎯 Project Filtering - Filter conversations by project
- 📱 Responsive Design - Works perfectly on desktop and mobile
- 💰 Detailed Cost Analysis - Track spending patterns over time
- 🔍 Smart Sorting - Intelligent sorting for text, numbers, and dates

🚀 Quick Start

You don't need to install anything! Just run:

``bash npx claude-code-summary`

`📈 What it analyzes`

This tool scans your Claude Code conversations in ~/.claude/projects/ and provides:

`$3`


- Total Costs - Aggregate spending across all conversations
- Conversation Count - Total number of analyzed conversations  
- Average Cost - Mean cost per conversation
$3

- Daily Cost Trends - Interactive line chart showing last 30 days
- Top Conversations - Bar chart of your most expensive conversations
- Project Breakdown - Filter and analyze by specific projects
$3

- Sortable Columns - Click any header to sort (Title, Project, Cost, Messages, Duration, Date)
- Rich Information - Conversation titles, project names, detailed costs, message counts, and timestamps
- Project Filtering - Focus on specific projects with dropdown filter
🎨 UI Features
- 🌙 Dark Mode - Enabled by default with elegant dark theme
- ☀️ Light Mode - Toggle to light mode with modern gradients  
- 📱 Responsive - Optimized for all screen sizes
- 🎯 Interactive - Hover effects and smooth animations
- 🔍 Sortable - Click any table column to sort data intelligently
🛠️ Technical Requirements

- Node.js 14.0.0 or higher - Claude Code conversations in~/.claude/projects/- Modern Browser for optimal HTML report experience

`📊 Output`

The analyzer generates:

1. 📱 Console Summary - Quick overview in your terminal 2. 🌐 Interactive HTML Report featuring: - Modern responsive design with dark/light themes - Interactive charts and visualizations - Sortable data tables with smart column sorting - Project-based filtering capabilities - Professional footer with developer attribution

`🔧 Usage Examples`

`bash

`Basic analysis`


npx claude-code-summary
The tool will:

1. Scan your ~/.claude/projects/ directory

2. Calculate costs for all conversations

3. Generate an interactive HTML report

4. Open the report in your default browser

🎯 Perfect for

- 💰 Cost Tracking - Monitor your Claude Code spending
- 📊 Usage Analysis - Understand your AI interaction patterns
- 🎯 Project Management - Analyze costs by project
- 📈 Trend Analysis - Track spending over time
- 🔍 Detailed Insights - Deep dive into conversation data

👨‍💻 Developer

Arda Kalaycı
- 🐙 GitHub: ardakalayci
- 💼 Professional software developer and AI enthusiast
- 🎯 Passionate about creating beautiful, functional tools

📄 License

MIT License - feel free to use, modify, and distribute!

---

⭐ Like this tool? Give it a star on GitHub and share it with other Claude Code users!