https://github.com/ktny/ccstat

Visualize your Claude Code session activity timeline — fast, beautiful, and insightful CLI tool
https://github.com/ktny/ccstat

claudecode cli typescript

Last synced: 5 months ago
JSON representation

Visualize your Claude Code session activity timeline — fast, beautiful, and insightful CLI tool

• Host: GitHub
• URL: https://github.com/ktny/ccstat
• Owner: ktny
• License: mit
• Created: 2025-06-21T01:01:27.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-07-07T12:55:13.000Z (12 months ago)
• Last Synced: 2025-09-12T07:57:01.738Z (10 months ago)
• Topics: claudecode, cli, typescript
• Language: TypeScript
• Homepage: https://www.npmjs.com/package/ccstat
• Size: 13.1 MB
• Stars: 15
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          


  



# ccstat

> Visualize your Claude Code session activity timeline — fast, beautiful, and insightful!

![License](https://img.shields.io/badge/license-MIT-blue.svg?style=for-the-badge)

## ✨ What is ccstat?

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.

![demo](assets/demo.png)

### 🎯 Key Features

- 📈 **Timeline Visualization** — Color-coded activity blocks showing your coding patterns

- 📁 **Git Integration** — Automatically groups projects by repository

- 🕐 **Flexible Time Ranges** — View activity by days (1+) or hours (1-24)

## 🚀 Installation

Install with a single command:

```sh

# Using npx

npx ccstat

# Using bunx (recommended for speed)

bunx ccstat

```

## 📖 Usage

### Basic Commands

```bash

# View last 24 hours of activity

npx ccstat

# View all period

npx ccstat -a

# View last 7 days

npx ccstat --days 7

# View last 6 hours

npx ccstat --hours 6

# View sorted events descending

npx ccstat --sort events --reverse -a

# View filtered projects

npx ccstat --project myproject1 myproject2

# View ocean color

npx ccstat --color ocean

```

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

---



  Built with ❤️ for the Claude Code community