Comprehensive development intelligence system for Claude Code sessions - tracks productivity, conversations, and learning patterns
Ryan Malloy
50c80596d0
Features Added: • Docker containerization with multi-stage Python 3.12 build • Caddy reverse proxy integration with automatic SSL • File upload interface for .claude.json imports with preview • Comprehensive hook system with 39+ hook types across 9 categories • Complete documentation system with Docker and import guides Technical Improvements: • Enhanced database models with hook tracking capabilities • Robust file validation and error handling for uploads • Production-ready Docker compose configuration • Health checks and resource limits for containers • Database initialization scripts for containerized deployments Documentation: • Docker Deployment Guide with troubleshooting • Data Import Guide with step-by-step instructions • Updated Getting Started guide with new features • Enhanced documentation index with responsive grid layout 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> |
||
|---|---|---|
| app | ||
| config | ||
| docs | ||
| tests | ||
| .dockerignore | ||
| .env.example | ||
| .gitignore | ||
| claude-hooks-basic.json | ||
| claude-hooks-comprehensive.json | ||
| claude-hooks-developer.json | ||
| claude-hooks-essential.json | ||
| claude-hooks-power_user.json | ||
| claude-hooks-research.json | ||
| claude-hooks-team.json | ||
| docker-compose.yml | ||
| docker-deploy.sh | ||
| DOCKER.md | ||
| Dockerfile | ||
| generate_hook_config.py | ||
| IMPLEMENTATION_SUMMARY.md | ||
| import_claude_data.py | ||
| init_db.py | ||
| main.py | ||
| pyproject.toml | ||
| pytest.ini | ||
| README.md | ||
| recalculate_project_stats.py | ||
| requirements-dev.txt | ||
| uv.lock | ||
Claude Code Hook Configurations
This directory contains various pre-configured hook setups for different use cases:
Available Configurations
basic.json
Essential hooks for basic session and tool tracking.
- Session management
- Tool calls
- File modifications
- Conversations
comprehensive.json
Complete hook setup with all available hook types.
- All performance monitoring
- Code quality tracking
- Learning analytics
- Collaboration insights
- Project intelligence
essential.json
Minimal setup for core functionality.
developer.json
Focused on development workflow and code quality.
- Essential hooks
- Performance monitoring
- Code quality checks
power_user.json
Advanced setup for productivity optimization.
- Essential hooks
- Performance tracking
- Workflow analysis
- Project intelligence
research.json
Optimized for learning and exploration.
- Essential hooks
- Learning tracking
- External resource usage
- Knowledge gap analysis
team.json
Team-focused configuration for collaboration.
- Essential hooks
- Collaboration tracking
- Testing workflows
- Project intelligence
Installation
- Choose the configuration that matches your needs
- Copy the JSON content to your Claude Code settings file:
- macOS/Linux:
~/.config/claude/settings.json - Windows:
%APPDATA%\claude\settings.json
- macOS/Linux:
- Ensure Claude Code Tracker is running on port 8000
- Start using Claude Code - hooks will automatically track your activity!
Available Hook Variables
Each hook can use these variables that Claude Code provides:
Session Variables
$SESSION_ID- Current session identifier$TIMESTAMP- Current timestamp (ISO format)$PWD- Current working directory$USER- System username
Tool Variables
$TOOL_NAME- Name of tool being called$TOOL_PARAMS- Tool parameters (JSON)$RESULT_STATUS- Success/error status$EXECUTION_TIME- Tool execution time (ms)$ERROR_TYPE- Type of error$ERROR_MESSAGE- Error message$STACK_TRACE- Error stack trace
File Variables
$FILE_PATH- Path to modified file$ACTION- File action (created/modified/deleted)$FILE_SIZE_MB- File size in megabytes
Context Variables
$CONTENT- Conversation content$CONTEXT- Current context description$SEARCH_QUERY- What you're searching for$NEW_PROJECT- Project being switched to$OLD_PROJECT- Project being switched from
Performance Variables
$MEMORY_MB- Memory usage in MB$DURATION_MS- Duration in milliseconds$THRESHOLD_EXCEEDED- Boolean for threshold alerts
And many more! Each hook type has specific variables available.
Customization
You can modify any configuration by:
- Adding/removing specific hooks
- Changing API endpoints or ports
- Adjusting timeout and retry settings
- Adding custom metadata to hook calls
Troubleshooting
If hooks aren't working:
- Ensure Claude Code Tracker server is running
- Check that curl is installed
- Verify the API endpoints are accessible
- Check Claude Code logs for hook execution errors
- Test individual hooks manually with curl
For more help, see the documentation at /dashboard/docs/hook-setup.