🍀
ClaudeCodeの活動をGitHubの草風に可視化するツールを作った
はじめに
ClaudeCodeを使っていて、今日はどれくらい働いてもらったのかを知りたいと思ったのでそれがわかるccstatというCLIツールを作りました。GitHubの草のような感じでClaudeCodeの労働を監督することができます。
ccstatの機能
ClaudeCodeは実行したディレクトリごとに~/.claude/projectsにセッションログを保存しているため、それを解析してディレクトリごとに指定の期間で活動履歴を表示、集計するのが主な機能です。
主な機能：
- 📊 活動量の可視化: GitHubの草風に色分けして表示
- ⏱️ スマートな時間計測: なるべく実際のアクティブ時間を計算
- 📁 プロジェクト別集計: ディレクトリごとの作業量を把握
- 🌲 Git統合: リポジトリ単位での集計とworktree対応
git worktreeなどを使っていると別のディレクトリでも同じリポジトリの作業ということがあるため、単にディレクトリではなくgitリポジトリが同じであればまとめて集計したり、リポジトリ単位で親子表示をすることなどができます。
実際に使ってみる
インストール
npx ccstat
基本的な使い方
ccstatと実行するだけで、現在から過去24時間のClaudeCodeの活動履歴をプロジェクトごとに見ることができます。
その他、もっと過去まで遡ったり、直近数時間に絞ることや、特定のプロジェクトのみに絞って表示することができます。
# 過去全履歴を表示
ccstat -a
# 過去7日間の活動を表示
ccstat --days 7
# 過去6時間の詳細な活動
ccstat --hours 6
# 特定のプロジェクトのみ表示
ccstat --project myproject
活用例
開発リズムの把握
# 今週の作業パターンをチェック
ccstat --days 7
プロジェクトの作業量確認
# 特定プロジェクトの集中度を見る
ccstat --project important-feature --hours 12
おわりに
このツールの開発にもClaudeCodeを使っていますが、本当に少し前では考えられないスピードでこのツールを開発することができました。
今まではアイデアを思いついたものの完成するまでに時間がかかり挫折するということもしばしばありましたがそんなことが相当減りそうです。
ちなみにGeminiCLI対応は検討中です。
使ってみた感想やスターなどいただけると大変うれしいです！
Discussion