Ryan Malloy
bec1606c86
## Documentation System - Create complete documentation hub at /dashboard/docs with: - Getting Started guide with quick setup and troubleshooting - Hook Setup Guide with platform-specific configurations - API Reference with all endpoints and examples - FAQ with searchable questions and categories - Add responsive design with interactive features - Update navigation in base template ## Tool Call Tracking - Add ToolCall model for tracking Claude Code tool usage - Create /api/tool-calls endpoints for recording and analytics - Add tool_call hook type with auto-session detection - Include tool calls in project statistics and recalculation - Track tool names, parameters, execution time, and success rates ## Project Enhancements - Add project timeline and statistics pages (fix 404 errors) - Create recalculation script for fixing zero statistics - Update project stats to include tool call counts - Enhance session model with tool call relationships ## Infrastructure - Switch from requirements.txt to pyproject.toml/uv.lock - Add data import functionality for claude.json files - Update database connection to include all new models - Add comprehensive API documentation 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
Claude Code Project Tracker
A comprehensive development intelligence system that tracks your Claude Code sessions, providing insights into your coding patterns, productivity, and learning journey.
Overview
The Claude Code Project Tracker automatically captures your development workflow through Claude Code's hook system, creating a detailed record of:
- Development Sessions - When you start/stop working, what projects you focus on
- Conversations - Full dialogue history with Claude for context and learning analysis
- Code Changes - File modifications, tool usage, and command executions
- Thinking Patterns - Wait times between interactions to understand your workflow
- Git Activity - Repository changes, commits, and branch operations
- Productivity Metrics - Engagement levels, output quality, and learning velocity
Architecture
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Claude Code │───▶│ Hook System │───▶│ FastAPI Server │
│ (your IDE) │ │ │ │ │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│
▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Web Dashboard │◀───│ Analytics │◀───│ SQLite Database │
│ │ │ Engine │ │ │
└─────────────────┘ └─────────────────┘ └─────────────────┘
Components
- FastAPI Server: REST API that receives hook data and serves analytics
- SQLite Database: Local storage for all tracking data
- Hook Integration: Claude Code hooks that capture development events
- Analytics Engine: Processes raw data into meaningful insights
- Web Dashboard: Interactive interface for exploring your development patterns
Key Features
🎯 Session Tracking
- Automatic project detection and session management
- Working directory and git branch context
- Session duration and engagement analysis
💬 Conversation Intelligence
- Full dialogue history with semantic search
- Problem-solving pattern recognition
- Learning topic identification and progress tracking
📊 Development Analytics
- Productivity metrics and engagement scoring
- Tool usage patterns and optimization insights
- Cross-project learning and code reuse analysis
🔍 Advanced Insights
- Think time analysis and flow state detection
- Git activity correlation with conversations
- Skill development velocity tracking
- Workflow optimization recommendations
Data Privacy
- Local-First: All data stays on your machine
- No External Services: No data transmission to third parties
- Full Control: Complete ownership of your development history
- Selective Tracking: Configurable hook activation per project
Quick Start
-
Install Dependencies
pip install -r requirements.txt -
Start the Tracking Server
python main.py -
Configure Claude Code Hooks
# Add hooks to your Claude Code settings cp config/claude-hooks.json ~/.config/claude-code/ -
Access Dashboard
Open http://localhost:8000 in your browser
Project Structure
claude-tracker/
├── README.md # This file
├── requirements.txt # Python dependencies
├── main.py # FastAPI application entry point
├── config/ # Configuration files
│ └── claude-hooks.json # Hook setup for Claude Code
├── app/ # Application code
│ ├── models/ # Database models
│ ├── api/ # API endpoints
│ ├── analytics/ # Insights engine
│ └── dashboard/ # Web interface
├── tests/ # Test suite
├── docs/ # Detailed documentation
└── data/ # SQLite database location
Documentation
- API Specification - Complete endpoint documentation
- Database Schema - Data model details
- Hook Setup Guide - Claude Code integration
- Development Guide - Local setup and contribution
- Analytics Guide - Understanding insights and metrics
Development
See Development Guide for detailed setup instructions.
# Install development dependencies
pip install -r requirements-dev.txt
# Run tests
pytest
# Start development server with hot reload
uvicorn main:app --reload
# Generate API documentation
python -m app.generate_docs
Contributing
This project follows test-driven development. Please ensure:
- All new features have comprehensive tests
- Documentation is updated for API changes
- Analytics insights are validated with test data
License
MIT License - See LICENSE file for details