cctotals 1.0.1 → 1.0.3

package/.github/workflows/publish.yml

@@ -9,17 +9,43 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
       
       - uses: actions/setup-node@v4
         with:
           node-version: '20'
           registry-url: 'https://registry.npmjs.org'
       
-      - name: Publish
+      - name: Setup git and npm
         run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
           echo "//registry.npmjs.org/:_authToken=$NPM_TOKEN" > .npmrc
           npm install -g npm
-          npm version patch --git-tag-version=false
-          npm publish --access public
         env:
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+      
+      - name: Get latest npm version
+        id: npm_version
+        run: |
+          LATEST=$(npm view cctotals version 2>/dev/null || echo "0.0.0")
+          echo "latest=$LATEST" >> $GITHUB_OUTPUT
+      
+      - name: Bump and publish
+        run: |
+          CURRENT=$(node -p "require('./package.json').version")
+          NPM_LATEST=${{ steps.npm_version.outputs.latest }}
+          
+          echo "Package version: $CURRENT, npm latest: $NPM_LATEST"
+          
+          # Check if npm already has this version
+          if npm view cctotals@$CURRENT version &>/dev/null; then
+            echo "Version $CURRENT exists on npm, bumping..."
+            npm version patch
+          fi
+          
+          NEW_VERSION=$(node -p "require('./package.json').version")
+          echo "Publishing $NEW_VERSION..."
+          git push origin HEAD:main --tags
+          npm publish --access public

package/README.md

@@ -0,0 +1,67 @@
+# cctotals
+
+📊 Analyze and visualize your Claude Code token usage with beautiful weekly graphs in the terminal.
+
+## Quick Start
+
+```bash
+bun x cctotals
+# or
+npx cctotals
+```
+
+## Features
+
+- 📈 Weekly token totals bar chart
+- 🤖 Breakdown by model (Sonnet, Haiku, etc.)
+- 🎨 Colorful terminal output
+- 📊 Statistics: total, average, per-week data
+
+## Installation
+
+```bash
+npm install -g cctotals
+```
+
+## Usage
+
+```bash
+cctotals
+```
+
+### Output Example
+
+```
+══════════════════════════════════════════════════════════════════════
+  WEEKLY TOKEN USAGE GRAPH
+══════════════════════════════════════════════════════════════════════
+
+  Week Start    | Tokens (scaled)
+────────────┼────────────────────────────────────────────────────────────
+  2026-02-23  │███████████████████████████████████████████████████████████  2,382,993
+  2026-03-02  │█                                                          15,378
+────────────┼────────────────────────────────────────────────────────────
+
+  Total:  2,398,371 tokens across 2 weeks
+  Average:  1,199,186 tokens/week
+
+══════════════════════════════════════════════════════════════════════
+
+  DETAILED BREAKDOWN BY MODEL
+──────────────────────────────────────────────────
+  claude-sonnet-4-6                    1,327,999 (55.4%)
+  claude-haiku-4-5-20251001            1,070,372 (44.6%)
+```
+
+## How It Works
+
+Reads from Claude Code's telemetry data at `~/.claude/stats-cache.json` and aggregates token usage by week.
+
+## Requirements
+
+- Node.js 18+ or Bun
+- Claude Code with telemetry enabled
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cctotals",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Analyze and visualize Claude Code token usage with weekly graphs",
   "main": "token-graph.js",
   "bin": {

package/token-graph.js

@@ -15,7 +15,6 @@ const stats = JSON.parse(fs.readFileSync(statsPath, 'utf8'));
 // Group daily tokens into weeks
 function getWeekKey(dateStr) {
   const date = new Date(dateStr);
-  // Get ISO week start (Monday)
   const day = date.getDay();
   const diff = date.getDate() - day + (day === 0 ? -6 : 1);
   const weekStart = new Date(date.setDate(diff));
@@ -24,7 +23,6 @@ function getWeekKey(dateStr) {
 
 const weeklyTokens = {};
 
-// Process daily model tokens
 for (const dayData of stats.dailyModelTokens) {
   const weekKey = getWeekKey(dayData.date);
   if (!weeklyTokens[weekKey]) {
@@ -37,67 +35,60 @@ for (const dayData of stats.dailyModelTokens) {
   }
 }
 
-// Sort weeks chronologically
 const sortedWeeks = Object.keys(weeklyTokens).sort();
-
-// Find max for scaling
 const maxTokens = Math.max(...sortedWeeks.map(w => weeklyTokens[w].total));
 
-// Chart settings
-const CHART_WIDTH = 60;
-const LABEL_WIDTH = 12;
-const BAR_HEIGHT = 1;
-const SCALE = CHART_WIDTH / maxTokens;
-
-// Colors for terminal (Windows-compatible)
-const colors = {
-  header: '\x1b[36m',     // Cyan
-  label: '\x1b[33m',      // Yellow  
-  bar: '\x1b[32m',        // Green
-  total: '\x1b[35m',      // Magenta
-  reset: '\x1b[0m'
+// Colors
+const c = {
+  hdr: '\x1b[36m',
+  lbl: '\x1b[33m',
+  bar: '\x1b[32m',
+  num: '\x1b[35m',
+  res: '\x1b[0m'
 };
 
-console.log('\n' + colors.header + '═'.repeat(70));
-console.log('  WEEKLY TOKEN USAGE GRAPH');
-console.log('═'.repeat(70) + colors.reset);
-console.log();
+// Terminal width
+const W = process.stdout.columns || 80;
+const CHART_W = Math.min(50, W - 30);
+const PAD = Math.floor((W - CHART_W - 30) / 2);
 
-// Draw the chart
-console.log(colors.label + '  Week Start    ' + colors.reset + '|' + colors.bar + ' Tokens (scaled)' + colors.reset);
+// Header
+console.log('\n' + c.hdr + '═'.repeat(W));
+console.log(' '.repeat(PAD) + 'WEEKLY TOKEN USAGE GRAPH');
+console.log('═'.repeat(W) + c.res);
+console.log();
 
-// Find longest bar needed for alignment
-const maxBarWidth = Math.floor(maxTokens / (maxTokens / CHART_WIDTH));
-const chartLine = '─'.repeat(LABEL_WIDTH) + '┼' + '─'.repeat(CHART_WIDTH);
-console.log(colors.label + chartLine + colors.reset);
+// Column headers
+const hdr = '  Week         Tokens';
+console.log(c.lbl + hdr + ' '.repeat(CHART_W - hdr.length + 5) + '| Bar' + c.res);
+console.log(c.lbl + '─'.repeat(W) + c.res);
 
 let grandTotal = 0;
 for (const week of sortedWeeks) {
   const data = weeklyTokens[week];
-  const barLen = Math.max(1, Math.floor(data.total / (maxTokens / CHART_WIDTH)));
-  const bar = colors.bar + '█'.repeat(barLen) + colors.reset;
-  const label = colors.label + week + colors.reset;
-  const spaces = ' '.repeat(Math.max(0, LABEL_WIDTH - label.length));
+  const barLen = Math.max(1, Math.floor((data.total / maxTokens) * CHART_W));
   
-  // Format token count with commas
+  // Format: week left-aligned, tokens right-aligned
+  const weekStr = week;
   const tokenStr = data.total.toLocaleString();
-  const padding = ' '.repeat(Math.max(0, CHART_WIDTH - barLen - tokenStr.length - 3));
+  const bar = c.bar + '█'.repeat(barLen) + c.res;
   
-  console.log(`  ${label}  │${bar}${padding} ${colors.total}${tokenStr}${colors.reset}`);
+  const line = `  ${c.lbl}${weekStr}${c.res}  ${c.num}${tokenStr}${c.res}  ${bar}`;
+  console.log(line);
   grandTotal += data.total;
 }
 
-// Footer
-console.log(colors.label + chartLine + colors.reset);
-console.log(`\n  ${colors.header}Total:${colors.reset} ${colors.total}${grandTotal.toLocaleString()}${colors.reset} tokens across ${sortedWeeks.length} weeks`);
-console.log(`  ${colors.header}Average:${colors.reset} ${Math.round(grandTotal / sortedWeeks.length).toLocaleString()} tokens/week`);
-console.log('\n' + colors.header + '═'.repeat(70) + colors.reset + '\n');
+console.log(c.lbl + '─'.repeat(W) + c.res);
+
+const avg = Math.round(grandTotal / sortedWeeks.length);
+console.log(`\n  Total:   ${c.num}${grandTotal.toLocaleString()}${c.res} tokens (${sortedWeeks.length} weeks)`);
+console.log(`  Average: ${c.num}${avg.toLocaleString()}${c.res} tokens/week`);
+console.log('\n' + c.hdr + '═'.repeat(W) + c.res + '\n');
 
-// Detailed breakdown by model
-console.log(colors.header + '  DETAILED BREAKDOWN BY MODEL' + colors.reset);
-console.log('─'.repeat(50));
+// Model breakdown
+console.log(c.hdr + '  MODEL BREAKDOWN' + c.res);
+console.log(c.lbl + '─'.repeat(W) + c.res);
 
-// Aggregate model stats
 const modelTotals = {};
 for (const week of sortedWeeks) {
   for (const [model, tokens] of Object.entries(weeklyTokens[week].byModel)) {
@@ -105,8 +96,10 @@ for (const week of sortedWeeks) {
   }
 }
 
+const maxModelLen = Math.max(...Object.keys(modelTotals).map(m => m.length));
 for (const [model, tokens] of Object.entries(modelTotals)) {
   const pct = ((tokens / grandTotal) * 100).toFixed(1);
-  console.log(`  ${model.padEnd(30)} ${tokens.toLocaleString().padStart(12)} (${pct}%)`);
+  const padded = model.padEnd(maxModelLen);
+  console.log(`  ${c.lbl}${padded}${c.res}  ${c.num}${tokens.toLocaleString()}${c.res}  (${pct}%)`);
 }
 console.log();