🤖 Claude Usage Tracker

The first automatic usage tracker for Claude AI - Monitor your time, sessions, and resource usage across all Claude interfaces

Features • Installation • Usage • Dashboard • Contributing

🌟 Features

✨ Automatic Detection

• 🌐 Browser Tracking - Automatically detects when you're using Claude.ai in any browser
• 💻 Terminal Tracking - Monitors Claude Code usage in terminal
• 📱 Mobile Support - Track sessions from mobile devices via remote logger
• 🔄 Smart Detection - Multiple detection methods ensure nothing is missed

📊 Comprehensive Analytics

• ⏱️ Time Tracking - Accurate session duration tracking
• 📈 Usage Statistics - Daily, weekly, and monthly usage reports
• 💾 Resource Monitoring - Track memory and CPU usage
• 🎯 Project Categorization - Organize usage by project
• 📁 Data Export - Export to CSV for expense reports

🎨 Beautiful Dashboard

• 📱 Responsive Design - Works on all screen sizes
• 📊 Real-time Charts - Visualize your usage patterns
• 🚦 Status Indicators - Know when tracking is active
• 🌙 Clean Interface - Easy on the eyes during long sessions

🚀 Easy to Use

• 🖱️ One-Click Launch - Simple app in your Applications folder
• 🔧 Zero Configuration - Works out of the box
• 💾 Automatic Backups - Never lose your data
• 🔒 Privacy First - All data stored locally on your machine

📦 Installation

Quick Install (Recommended)

1. Clone the repository:

git clone https://github.com/edmundbogen/claude-usage-tracker.git
cd claude-usage-tracker

2. Run the setup:

python3 -m venv venv
source venv/bin/activate
pip install flask flask-cors sqlalchemy requests psutil

3. Create the app:

chmod +x create_app_bundle.sh
./create_app_bundle.sh

4. Launch the app:
   • Find "Claude Tracker" in your Applications folder
   • Or double-click "Claude Tracker.command" on your Desktop

🎮 Usage

Starting the Tracker

1. Launch from Applications:

   • Open Finder → Applications → Claude Tracker
   • Click "Start Auto-Tracker"

2. Or use Terminal:

cd ~/claude-usage-tracker
source venv/bin/activate
python smart_auto_tracker.py

Viewing the Dashboard

• Navigate to http://localhost:5002 in your browser
• Or click "Open Dashboard" in the Control Panel

Remote Tracking (Mobile/Other Devices)

• Open http://your-mac-ip:5002/remote on your mobile device
• Replace your-mac-ip with your Mac's IP address

📊 Dashboard Views

• Compact Dashboard: http://localhost:5002/
• Manual Dashboard: http://localhost:5002/manual
• Remote Logger: http://localhost:5002/remote

🛠️ Components

• app_v2.py - Flask dashboard server
• smart_auto_tracker.py - Main automatic tracker
• enhanced_tracker.py - Enhanced tracking with confidence scoring
• resource_monitor.py - Memory/CPU monitoring
• ClaudeTrackerLauncher.py - GUI control panel

🤝 Contributing

We welcome contributions! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

💬 Support

• Issues: GitHub Issues
• Email: edmund.bogen@gmail.com

---

Made with ❤️ for the Claude community