The latest articles on Forem by ktny (@ktny). https://forem.com/ktny https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F423978%2Ff7612ee0-03ee-4499-b8f0-f534a9a2884a.png https://forem.com/ktny en ktny Sun, 29 Jun 2025 13:30:32 +0000 https://forem.com/ktny/i-built-a-tool-to-visualize-claude-code-activity-like-github-contributions-d6 https://forem.com/ktny/i-built-a-tool-to-visualize-claude-code-activity-like-github-contributions-d6 <h2> Introduction </h2> <p>As a heavy Claude Code user, I often wondered: "How much did Claude actually work for me today?" So I created ccstat - a CLI tool that visualizes your Claude Code sessions in a GitHub contribution graph style. Think of it as monitoring your AI pair programmer's productivity! 🤖</p> <p><a href="https://github.com/ktny/ccstat" rel="noopener noreferrer">ktny/ccstat: 📊 Visualize your Claude Code session activity patterns — fast, beautiful, and insightful CLI tool</a></p> <h2> Features </h2> <p>Claude Code stores session logs in ~/.claude/projects for each directory where it's executed. ccstat analyzes these logs to display and aggregate activity history by directory over specified time periods.<br> Main features:</p> <ul> <li>📊 Activity visualization: GitHub-style contribution heatmap with color-coded intensity</li> <li>⏱️ Smart time tracking: Calculates actual active time as accurately as possible</li> <li>📁 Project-wise aggregation: Track work volume per directory</li> <li>🌲 Git integration: Repository-based aggregation with worktree support</li> </ul> <p>The Git integration is particularly useful when using git worktree - different directories might represent work on the same repository. ccstat intelligently groups these together and can display parent-child relationships at the repository level.</p> <h2> Getting Started </h2> <h3> Installation </h3> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>curl <span class="nt">-fsSL</span> https://ktny.github.io/ccstat/install.sh | sh </code></pre> </div> <h3> Basic Usage </h3> <p>Simply run:<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code>ccstat </code></pre> </div> <p>This shows Claude Code activity for the past 24 hours, organized by project.</p> <h3> Advanced Usage </h3> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code><span class="c"># Display worktree relationships</span> ccstat <span class="nt">--worktree</span> <span class="c"># Show past 7 days of activity</span> ccstat <span class="nt">--days</span> 7 <span class="c"># Show detailed activity for past 6 hours</span> ccstat <span class="nt">--hours</span> 6 <span class="c"># Focus on specific project</span> ccstat <span class="nt">--project</span> myproject </code></pre> </div> <h2> Use Cases </h2> <p>Understanding Your Development Rhythm<br> </p> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code><span class="c"># Check this week's work patterns</span> ccstat <span class="nt">--days</span> 7 </code></pre> </div> <div class="highlight js-code-highlight"> <pre class="highlight shell"><code><span class="c"># See concentration on a specific project</span> ccstat <span class="nt">--project</span> important-feature <span class="nt">--hours</span> 12 </code></pre> </div> <h2> Behind the Scenes </h2> <p>Building this tool was incredibly fast thanks to Claude Code itself - the speed of development was unimaginable just a short while ago. Ideas that used to take forever to complete (and often led to abandonment) can now be built rapidly.<br> I'm also considering Gemini CLI support in the future.</p> <h2> Wrapping Up </h2> <p>If you try ccstat, I'd love to hear your feedback! Stars on GitHub are always appreciated too! ⭐</p> cli opensource ai productivity