claude-code-summary

🎯 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:

npx claude-code-summary

📈 What it analyzes

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

💡 Summary Cards

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

📊 Visual Analytics

• 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

🗂️ Detailed Data Table

• 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:

• 📱 Console Summary - Quick overview in your terminal
• 🌐 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

# 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!