# ๐ Claude Code Project Tracker
**๐ฏ The Ultimate Development Intelligence System for Claude Code Users**
*Transform your coding journey into data-driven insights with real-time tracking, comprehensive analytics, and seamless automation*
[](./docker-compose.yml)
[](https://fastapi.tiangolo.com/)
[](https://caddyserver.com/)
[](#-data-import--file-upload)
[](#-hook-profiles--automation)
---
## โจ What Makes This Project AWESOME?
### ๐ญ **It's Like Having a Personal Data Scientist for Your Code**
Stop wondering *"What did I work on last week?"* or *"How productive was I this month?"*. Claude Code Tracker automatically captures everything, analyzes your patterns, and presents beautiful insights about your development journey.
### ๐ฅ **Zero-Friction Setup That Just Works**
```bash
# Literally 4 commands and you're tracking everything!
git clone https://git.supported.systems/claude/claude-code-tracker.git
cd claude-code-tracker
docker-compose up -d
./setup-hooks
```
**That's it!** ๐ Your tracker is live, hooks are installed, and data is flowing.
### ๐ง **Smart Enough to Surprise You**
- **File Upload with AI Preview** - Drag your `.claude.json`, get instant insights
- **39+ Hook Types** - More comprehensive than any other Claude Code tracker
- **7 User Profiles** - From beginners to teams, we've got your use case covered
- **Language Detection** - Automatically figures out what you're coding in
- **Timeline Visualization** - See your coding journey unfold over time
---
## ๐ **Features That Will Blow Your Mind**
|
### ๐ฏ **Real-Time Intelligence**
- **Live Session Tracking** - Watch your productivity in real-time
- **Conversation History** - Never lose a brilliant Claude exchange again
- **Project Analytics** - Deep insights per project with visual timelines
- **Smart File Monitoring** - Know exactly what files you're touching
|
### ๐ **Next-Level Automation**
- **One-Click Hook Install** - `./setup-hooks` and you're done
- **7 Pre-Built Profiles** - Choose your adventure (basic โ comprehensive)
- **Auto-Domain Config** - Works with any domain instantly
- **Self-Healing Setup** - Backups, verification, rollbacks included
|
|
### ๐ **Beautiful Visualizations**
- **Interactive Dashboards** - Bootstrap 5 + Chart.js magic
- **Project Timelines** - See your development story unfold
- **Productivity Heatmaps** - Identify your peak coding hours
- **Conversation Search** - Full-text search through all interactions
|
### ๐ **Privacy-First Design**
- **100% Local** - Your data never leaves your server
- **Docker Containerized** - Secure, isolated, professional
- **HTTPS Ready** - Automatic SSL with Caddy integration
- **User-Scope Only** - No system changes, completely reversible
|
---
## ๐ **Get Started in 60 Seconds**
### ๐ณ **Docker Deployment** (Recommended for Everyone)
*The fastest way to get a production-ready tracker with SSL, monitoring, and all the bells and whistles*
```bash
# ๐ฌ Step 1: Get the goods
git clone https://git.supported.systems/claude/claude-code-tracker.git claude-tracker
cd claude-tracker
# ๐ง Step 2: Configure your domain
cp .env.example .env
echo "DOMAIN=your-awesome-domain.com" >> .env
# ๐ Step 3: Launch the beast
docker-compose up -d
# ๐ฏ Step 4: Install hooks (on your dev machine)
export DOMAIN=your-awesome-domain.com
./setup-hooks
# ๐ Step 5: Start coding and watch the magic happen!
```
**๐ Boom! You now have a professional-grade development intelligence system!**
Visit `https://your-awesome-domain.com/dashboard` and prepare to be amazed ๐คฉ
### ๐ป **Local Development** (For the Tinkerers)
```bash
# Clone and setup
git clone https://git.supported.systems/claude/claude-code-tracker.git claude-tracker
cd claude-tracker
# Python magic
pip install -r requirements.txt
python init_db.py
python main.py
# Hook installation
export DOMAIN=localhost:8000
./setup-hooks
# Visit http://localhost:8000/dashboard
```
---
## ๐ญ **Hook Profiles: Choose Your Adventure**
*Not all developers are the same. We've got 7 carefully crafted profiles to match your workflow*
| Profile |
Hooks |
Perfect For |
What You Get |
| ๐ฑ basic |
5 |
New Users |
Essential session and conversation tracking. Clean, simple, effective. |
| โก essential |
8 |
Most Developers |
Core development tracking with file monitoring and tool usage. |
| ๐ฏ comprehensive |
39+ |
Data Lovers |
EVERYTHING! Complete tracking, analytics, performance, quality metrics. |
| ๐ผ developer |
15 |
Professionals |
Code quality, testing, deployment tracking for serious developers. |
| ๐ฅ power_user |
20 |
Advanced Users |
Performance monitoring, workflow optimization, productivity analytics. |
| ๐ฌ research |
25 |
Researchers |
Learning patterns, exploration tracking, knowledge gap analysis. |
| ๐ฅ team |
18 |
Collaborative Teams |
Collaboration insights, sharing patterns, team productivity metrics. |
**๐ฎ Switch profiles anytime:** `./install-hooks.sh power_user`
---
## ๐๏ธ **Architecture That Actually Makes Sense**
*We built this right. Modern, scalable, maintainable.*
```mermaid
graph TB
A[๐ Claude Code] --> B[๐ฏ Hooks System]
B --> C[๐ FastAPI Backend]
C --> D[๐ SQLite Database]
C --> E[๐จ Bootstrap Dashboard]
F[๐ File Upload] --> C
G[๐ณ Docker Container] --> H[๐ Caddy Proxy]
H --> I[๐ Your Domain]
style A fill:#e1f5fe
style C fill:#f3e5f5
style E fill:#e8f5e8
style I fill:#fff3e0
```
### ๐ ๏ธ **Tech Stack That Rocks**
| Component | Technology | Why It's Awesome |
|-----------|------------|------------------|
| **Backend** | FastAPI + Python 3.12 | โก Blazing fast, async everything, automatic OpenAPI docs |
| **Database** | SQLite + SQLAlchemy 2.0 | ๐๏ธ Zero config, async ORM, perfect for single-user deployments |
| **Frontend** | Bootstrap 5 + Jinja2 | ๐จ Responsive, accessible, server-side rendered |
| **Deployment** | Docker + Caddy | ๐ One command deploy, automatic SSL, reverse proxy magic |
| **Package Manager** | uv | โก 10-100x faster than pip, modern Python tooling |
---
## ๐ธ **Screenshots Worth a Thousand Words**
*Because seeing is believing*
### ๐ฏ **Dashboard Overview**
> *See your development activity at a glance with beautiful charts and metrics*
### ๐ **Project Analytics**
> *Deep dive into individual projects with timelines, language breakdowns, and activity patterns*
### ๐ **Conversation Search**
> *Find any Claude Code interaction instantly with powerful full-text search*
### ๐ **File Upload Magic**
> *Drag and drop your .claude.json file and watch the AI analyze and preview your data*
---
## ๐ฎ **Advanced Usage & Pro Tips**
๐ฅ Power User Tricks (Click to expand)
### ๐ฏ **Custom Hook Profiles**
```bash
# Create your own profile by copying and modifying existing ones
cp claude-hooks-comprehensive.json claude-hooks-myprofile.json
# Edit the file to your needs
./install-hooks.sh myprofile
```
### ๐ **Profile Switching Made Easy**
```bash
# Switch between profiles anytime
./install-hooks.sh basic # Start simple
./install-hooks.sh comprehensive # Go full power
./install-hooks.sh --verify # Check what's installed
```
### ๐ ๏ธ **Domain Management**
```bash
# Switch domains without rebuilding
./install-hooks.sh -d new-domain.com comprehensive
# Multiple environments
./install-hooks.sh -d localhost:8000 developer # Local dev
./install-hooks.sh -d staging.example.com team # Staging
./install-hooks.sh -d prod.example.com comprehensive # Production
```
### ๐ **Debugging & Troubleshooting**
```bash
# Verify everything is working
./install-hooks.sh --verify
# Check Docker logs
docker-compose logs -f
# Test connectivity
curl https://your-domain.com/health
# Uninstall cleanly
./install-hooks.sh --uninstall
```
๐ณ Docker Deployment Deep Dive (Click to expand)
### ๐๏ธ **Production-Ready Features**
- **Multi-stage builds** with uv for lightning-fast dependency installation
- **Health checks** with automatic restart policies
- **Resource limits** to prevent runaway processes
- **Volume mounting** for data persistence
- **Automatic SSL** via Caddy docker-proxy integration
### ๐ง **Environment Configuration**
```bash
# .env file configuration
DOMAIN=your-domain.com
DATABASE_URL=sqlite+aiosqlite:////app/data/tracker.db
DEBUG=false
PYTHONPATH=/app
```
### ๐ **Monitoring & Maintenance**
```bash
# Container health
docker-compose ps
docker-compose logs
# Database backup
cp ./data/tracker.db ./backups/tracker-$(date +%Y%m%d).db
# Updates
git pull
docker-compose build --no-cache
docker-compose up -d
```
---
## ๐ค **Contributing & Community**
*Join the revolution! Help make Claude Code tracking even more awesome*
### ๐ฏ **Ways to Contribute**
- ๐ **Bug Reports** - Found something broken? We want to know!
- ๐ก **Feature Requests** - Got ideas? Share them!
- ๐ **Documentation** - Help others discover the magic
- ๐ง **Code Contributions** - PRs welcome and appreciated
- ๐จ **UI/UX Improvements** - Make it even more beautiful
- ๐งช **Testing** - Help us ensure quality across environments
### ๐ **Recognition Wall**
*Contributors who made this project awesome:*
- **You!** - For considering contributing to this amazing project
---
## ๐ **Documentation That Actually Helps**
*Comprehensive guides that get you from zero to hero*
| ๐ Guide | ๐ฏ Purpose | โฑ๏ธ Time |
|----------|-----------|---------|
| [๐ Getting Started](./app/dashboard/templates/docs/getting-started.html) | Your first steps to tracking mastery | 5 min |
| [๐ Data Import Guide](./app/dashboard/templates/docs/data-import.html) | Master the file upload system | 3 min |
| [๐ณ Docker Deployment](./app/dashboard/templates/docs/docker-deployment.html) | Production deployment like a pro | 10 min |
| [๐ฏ Hook Setup](./app/dashboard/templates/docs/hook-setup.html) | Automated and manual installation | 7 min |
| [๐ Hook Reference](./app/dashboard/templates/docs/hook-reference.html) | Complete hook documentation | Reference |
| [๐ง API Documentation](./docs) | Interactive API exploration | Reference |
---
## ๐ **What Users Are Saying**
> *"I wish I had this when I started using Claude Code. The insights are incredible!"*
> **- Future You**
> *"The Docker setup just works. One command and I had a professional tracking system running."*
> **- Developers Everywhere**
> *"39+ hooks?! This tracks everything I didn't even know I wanted to track."*
> **- Data Enthusiasts**
---
## ๐ฎ **What's Coming Next**
*The future is bright! Here's what we're cooking up*
- ๐ฑ **Mobile Dashboard** - Check your stats on the go
- ๐ค **AI Insights** - Let AI analyze your patterns and suggest improvements
- ๐ **Team Features** - Collaborative tracking and insights
- ๐ **Advanced Analytics** - Even more beautiful visualizations
- ๐ **Plugin System** - Extend functionality with custom plugins
- ๐ **Multi-Language Support** - Because code is universal
---
## ๐จ **FAQ: The Questions Everyone Asks**
โ Is my data safe and private?
**Absolutely!** Everything runs on your server. No data ever leaves your infrastructure. It's like having your own private Google Analytics for coding.
โ Will this slow down Claude Code?
**Nope!** Hooks are lightweight HTTP calls that run asynchronously. You won't notice any difference in Claude Code performance.
โ Can I use this with multiple domains?
**Yes!** Switch domains anytime with `./install-hooks.sh -d new-domain.com`. Perfect for dev/staging/prod environments.
โ What if I want to stop tracking?
**Easy!** Run `./install-hooks.sh --uninstall` and everything goes back to normal. No traces left behind.
โ Can I customize what gets tracked?
**Totally!** Choose from 7 profiles or create your own by editing the JSON files. Full control over your data.
---
## ๐ **License & Legal**
**MIT Licensed** - Use it, modify it, love it, share it
*This project is not affiliated with Anthropic. Claude Code is a trademark of Anthropic.*
---
## ๐ **Ready to Transform Your Development Experience?**
### ๐ **One Command to Rule Them All**
```bash
git clone https://git.supported.systems/claude/claude-code-tracker.git && cd claude-code-tracker && docker-compose up -d && ./setup-hooks
```
**That's it!** Welcome to the future of development intelligence ๐
---
[](https://github.com/yourusername)
[](https://claude.ai/code)
[](https://buymeacoffee.com/yourhandle)
**โญ Star this repo if it made your coding life better!**