.png)
4 months ago
8
Visualize your Claude Code session activity timeline — fast, beautiful, and insightful!
ccstat is a powerful CLI tool that analyzes your Claude Code session history and transforms it into beautiful timeline visualizations. Track your coding patterns and gain insights into your development workflow.
- 📈 Timeline Visualization — Color-coded activity blocks showing your coding patterns
- ⏱️ Smart Duration Tracking — Calculates active work time with intelligent break detection
- 🎨 Activity Density — Five-level visual density indicators from idle to very high
- 📁 Git Integration — Automatically groups projects by repository
- 🌳 Worktree Support — Separate visualization for different worktree directories
- 🕐 Flexible Time Ranges — View activity by days (1+) or hours (1-24)
- 🔍 Project Filtering — Focus on specific projects
- ⚡ High Performance — Optimized file processing for fast results
Install the latest version with a single command:
The installer automatically:
- Detects your OS and architecture
- Downloads the appropriate binary
- Installs to /usr/local/bin (with sudo) or ~/.local/bin (without sudo)
- Verifies the installation
For specific versions or custom installation paths:
Download the latest release binary for your platform from GitHub Releases:
- Project: Git repository name or directory name
- Timeline: Visual activity timeline with color-coded density
- Events: Number of messages in the session
- Duration: Active work time in minutes
- Hours view: 15min/30min/1h/2h/3h/4h intervals
- Single day: Hour markers (0, 6, 12, 18)
- Multiple days: Date intervals
Active Time Calculation: Only counts periods where message intervals are ≤1 minute as active time, excluding long breaks to measure actual work time.
Git Integration: Automatically detects and groups projects by Git repository, showing parent-child relationships for complex project structures.
- Go 1.21+ for building from source
- Claude Code for generating session logs
- Git (recommended) for project integration features
- Linux (x86_64, ARM64)
- macOS (Intel, Apple Silicon)
- Note: Windows is not currently supported
This project is licensed under the MIT License - see the LICENSE file for details.
Built with ❤️ for the Claude Code community
