cc-size 1.0.0

package/README.md

@@ -0,0 +1,58 @@
+# cc-size
+
+How much conversation history have you accumulated? Shows total disk usage and growth rate of your Claude Code sessions.
+
+```
+cc-size — Your Claude Code conversation history
+
+  Total size:    6.1 GB
+  Total files:   755 sessions
+  Date range:    2026-01-10 → 2026-03-01
+  Daily growth:  ~81.8 MB/day (last 30 days)
+  Largest file:  1.0 GB
+  At this rate:  10 GB by ~2026-04
+
+──────────────────────────────────────────────────────
+  Monthly growth
+
+  2026-01  ████████████████████████    3.7 GB
+  2026-02  ██████████████░░░░░░░░░░    2.2 GB
+  2026-03  █░░░░░░░░░░░░░░░░░░░░░░░  231.1 MB (in progress)
+
+──────────────────────────────────────────────────────
+  By project (top 8)
+
+  ~/ (home)          ████████████████████████    5.7 GB
+  projects-cc-loop   █░░░░░░░░░░░░░░░░░░░░░░░  224.8 MB
+  draemorth          ░░░░░░░░░░░░░░░░░░░░░░░░   59.0 MB
+```
+
+## Usage
+
+```bash
+npx cc-size              # Total history size and growth
+npx cc-size --all        # Include subagent session files
+npx cc-size --json       # JSON output
+```
+
+## What it shows
+
+- **Total size** — cumulative disk usage of all `.jsonl` session files
+- **Sessions** — number of conversation files
+- **Daily growth** — average bytes added per day over the last 30 days
+- **Largest file** — size of your biggest single session
+- **Growth projection** — estimated date to reach 10 GB at current rate
+- **Monthly chart** — month-by-month storage breakdown
+- **By project** — top 8 projects by storage consumed
+
+## Privacy
+
+Reads file **metadata only** (size + modification time). No file content is accessed or transmitted. Everything runs locally.
+
+## Browser version
+
+Drop your `~/.claude` folder into [cc-size on the web](https://yurukusa.github.io/cc-size/) for the same analysis — no install required.
+
+---
+
+Part of [cc-toolkit](https://yurukusa.github.io/cc-toolkit/) — 60 free tools for Claude Code

package/cli.mjs

@@ -0,0 +1,211 @@
+#!/usr/bin/env node
+/**
+ * cc-size — How much conversation history have you accumulated?
+ * Shows total disk usage and growth rate of your Claude Code sessions.
+ */
+
+import { readdirSync, statSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+
+const args = process.argv.slice(2);
+const jsonMode = args.includes('--json');
+const showHelp = args.includes('--help') || args.includes('-h');
+const includeSubagents = args.includes('--all'); // include subagent files
+
+if (showHelp) {
+  console.log(`cc-size — How much conversation history have you accumulated?
+
+Usage:
+  npx cc-size              # Total history size and growth
+  npx cc-size --all        # Include subagent session files
+  npx cc-size --json       # JSON output
+`);
+  process.exit(0);
+}
+
+const claudeDir = join(homedir(), '.claude', 'projects');
+
+function humanSize(bytes) {
+  if (bytes >= 1024 * 1024 * 1024) return (bytes / (1024 * 1024 * 1024)).toFixed(1) + ' GB';
+  if (bytes >= 1024 * 1024) return (bytes / (1024 * 1024)).toFixed(1) + ' MB';
+  if (bytes >= 1024) return (bytes / 1024).toFixed(1) + ' KB';
+  return bytes + ' B';
+}
+
+function getISOMonth(date) {
+  return `${date.getFullYear()}-${String(date.getMonth() + 1).padStart(2, '0')}`;
+}
+
+/**
+ * Convert project directory name to human-readable project label.
+ * "-home-namakusa-projects-cc-loop" -> "projects-cc-loop"
+ * "-home-namakusa" -> "~/ (home)"
+ */
+function projectName(dirName) {
+  // Remove leading "-home-[username]" prefix (with or without trailing dash)
+  const stripped = dirName.replace(/^-home-[^-]+/, '').replace(/^-/, '');
+  if (!stripped) return '~/ (home)';
+  return stripped;
+}
+
+const byProject = {};
+const byMonth = {};
+let totalFiles = 0;
+let totalBytes = 0;
+let oldestDate = null;
+let newestDate = null;
+let largestFile = { size: 0, path: '' };
+
+let projectDirs;
+try {
+  projectDirs = readdirSync(claudeDir);
+} catch {
+  console.error(`Cannot read ${claudeDir}`);
+  process.exit(1);
+}
+
+for (const projDir of projectDirs) {
+  const projPath = join(claudeDir, projDir);
+  let stat;
+  try {
+    stat = statSync(projPath);
+    if (!stat.isDirectory()) continue;
+  } catch {
+    continue;
+  }
+
+  let entries;
+  try {
+    entries = readdirSync(projPath);
+  } catch {
+    continue;
+  }
+
+  for (const entry of entries) {
+    if (!entry.endsWith('.jsonl')) continue;
+    if (!includeSubagents && projPath.includes('/subagents/')) continue;
+
+    const filePath = join(projPath, entry);
+    let fstat;
+    try {
+      fstat = statSync(filePath);
+      if (!fstat.isFile()) continue;
+    } catch {
+      continue;
+    }
+
+    const size = fstat.size;
+    const mtime = new Date(fstat.mtime);
+    const month = getISOMonth(mtime);
+
+    totalFiles++;
+    totalBytes += size;
+
+    // By project
+    if (!byProject[projDir]) byProject[projDir] = { bytes: 0, files: 0, name: projectName(projDir) };
+    byProject[projDir].bytes += size;
+    byProject[projDir].files++;
+
+    // By month
+    byMonth[month] = (byMonth[month] || 0) + size;
+
+    // Tracking
+    if (!oldestDate || mtime < oldestDate) oldestDate = mtime;
+    if (!newestDate || mtime > newestDate) newestDate = mtime;
+    if (size > largestFile.size) largestFile = { size, path: filePath.replace(homedir(), '~') };
+  }
+}
+
+if (totalFiles === 0) {
+  console.error('No session files found.');
+  process.exit(1);
+}
+
+// Calculate growth rate from last 30 days
+const now = new Date();
+const thirtyDaysAgo = new Date(now - 30 * 24 * 60 * 60 * 1000);
+let last30DaysBytes = 0;
+for (const [month, bytes] of Object.entries(byMonth)) {
+  const [yr, mo] = month.split('-').map(Number);
+  const monthStart = new Date(yr, mo - 1, 1);
+  if (monthStart >= thirtyDaysAgo) last30DaysBytes += bytes;
+}
+const dailyGrowth = last30DaysBytes / 30;
+
+// Sorted projects by size
+const sortedProjects = Object.entries(byProject).sort((a, b) => b[1].bytes - a[1].bytes);
+const sortedMonths = Object.entries(byMonth).sort((a, b) => a[0].localeCompare(b[0]));
+
+if (jsonMode) {
+  console.log(JSON.stringify({
+    total_bytes: totalBytes,
+    total_size: humanSize(totalBytes),
+    total_files: totalFiles,
+    daily_growth_bytes: Math.round(dailyGrowth),
+    daily_growth: humanSize(dailyGrowth),
+    oldest_session: oldestDate?.toISOString().slice(0, 10),
+    newest_session: newestDate?.toISOString().slice(0, 10),
+    largest_file: { path: largestFile.path, size: humanSize(largestFile.size) },
+    by_month: Object.fromEntries(sortedMonths.map(([m, b]) => [m, humanSize(b)])),
+    by_project: sortedProjects.slice(0, 10).map(([dir, d]) => ({
+      project: d.name,
+      size: humanSize(d.bytes),
+      files: d.files,
+    })),
+  }, null, 2));
+  process.exit(0);
+}
+
+// Display
+const BAR_WIDTH = 24;
+const maxMonthBytes = Math.max(...Object.values(byMonth));
+const maxProjBytes = sortedProjects[0]?.[1].bytes || 1;
+
+function bar(bytes, max) {
+  const filled = Math.round((bytes / max) * BAR_WIDTH);
+  return '█'.repeat(filled) + '░'.repeat(BAR_WIDTH - filled);
+}
+
+function rpad(str, len) {
+  return str + ' '.repeat(Math.max(0, len - str.length));
+}
+
+console.log('cc-size — Your Claude Code conversation history\n');
+
+// Stats header
+console.log(`  Total size:    ${humanSize(totalBytes)}`);
+console.log(`  Total files:   ${totalFiles.toLocaleString()} sessions`);
+console.log(`  Date range:    ${oldestDate?.toISOString().slice(0, 10)} → ${newestDate?.toISOString().slice(0, 10)}`);
+console.log(`  Daily growth:  ~${humanSize(dailyGrowth)}/day (last 30 days)`);
+console.log(`  Largest file:  ${humanSize(largestFile.size)}`);
+
+// Growth projection
+if (dailyGrowth > 0) {
+  const daysTo10GB = (10 * 1024 * 1024 * 1024 - totalBytes) / dailyGrowth;
+  if (daysTo10GB > 0 && daysTo10GB < 3650) {
+    const projDate = new Date(now.getTime() + daysTo10GB * 86400000);
+    console.log(`  At this rate:  10 GB by ~${projDate.toISOString().slice(0, 7)}`);
+  }
+}
+
+console.log('\n' + '─'.repeat(54));
+console.log('  Monthly growth\n');
+
+for (const [month, bytes] of sortedMonths.slice(-12)) {
+  const current = month === getISOMonth(now);
+  const tag = current ? ' (in progress)' : '';
+  const sizeStr = humanSize(bytes).padStart(8);
+  console.log(`  ${month}  ${bar(bytes, maxMonthBytes)}  ${sizeStr}${tag}`);
+}
+
+console.log('\n' + '─'.repeat(54));
+console.log('  By project (top 8)\n');
+
+const maxProjLabel = Math.max(...sortedProjects.slice(0, 8).map(([, d]) => d.name.length));
+
+for (const [, data] of sortedProjects.slice(0, 8)) {
+  const label = rpad(data.name, maxProjLabel);
+  const sizeStr = humanSize(data.bytes).padStart(8);
+  console.log(`  ${label}  ${bar(data.bytes, maxProjBytes)}  ${sizeStr}`);
+}

package/index.html

@@ -0,0 +1,235 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>cc-size — Claude Code history size</title>
+<style>
+  * { box-sizing: border-box; margin: 0; padding: 0; }
+  body {
+    background: #0d1117;
+    color: #c9d1d9;
+    font-family: 'SF Mono', 'Consolas', 'Cascadia Code', monospace;
+    min-height: 100vh;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    padding: 40px 20px;
+  }
+  h1 { font-size: 1.5rem; color: #79c0ff; margin-bottom: 6px; }
+  .subtitle { color: #8b949e; font-size: 0.875rem; margin-bottom: 32px; }
+
+  .drop-zone {
+    border: 2px dashed #30363d;
+    border-radius: 12px;
+    padding: 48px 64px;
+    text-align: center;
+    cursor: pointer;
+    transition: all 0.2s;
+    max-width: 480px;
+    width: 100%;
+    margin-bottom: 32px;
+  }
+  .drop-zone:hover, .drop-zone.drag-over { border-color: #79c0ff; background: rgba(121,192,255,0.05); }
+  .drop-text { color: #8b949e; font-size: 0.875rem; line-height: 1.6; }
+  .drop-text strong { color: #c9d1d9; }
+  #file-input { display: none; }
+
+  .result { display: none; max-width: 600px; width: 100%; }
+  .result.visible { display: block; }
+  .card { background: #161b22; border: 1px solid #30363d; border-radius: 8px; padding: 20px; margin-bottom: 16px; }
+  .card-title { color: #8b949e; font-size: 0.75rem; text-transform: uppercase; letter-spacing: 1px; margin-bottom: 16px; }
+
+  .stats-grid { display: grid; grid-template-columns: repeat(2, 1fr); gap: 16px; margin-bottom: 16px; }
+  @media (min-width: 500px) { .stats-grid { grid-template-columns: repeat(4, 1fr); } }
+  .stat-item { text-align: center; }
+  .stat-val { font-size: 1.3rem; color: #79c0ff; font-weight: 700; }
+  .stat-lbl { font-size: 0.7rem; color: #8b949e; margin-top: 2px; }
+
+  .growth-badge {
+    text-align: center;
+    padding: 10px;
+    background: rgba(121,192,255,0.1);
+    border: 1px solid rgba(121,192,255,0.3);
+    border-radius: 6px;
+    font-size: 0.9rem;
+    color: #79c0ff;
+  }
+
+  .bar-chart { font-size: 0.78rem; }
+  .bar-row { display: flex; align-items: center; gap: 8px; margin-bottom: 6px; }
+  .bar-label { width: 72px; text-align: right; color: #8b949e; flex-shrink: 0; }
+  .bar-label-wide { width: 160px; text-align: right; color: #c9d1d9; flex-shrink: 0; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+  .bar-track { flex: 1; height: 14px; background: #21262d; border-radius: 3px; overflow: hidden; }
+  .bar-fill-month { height: 100%; background: #79c0ff; border-radius: 3px; transition: width 0.5s ease; }
+  .bar-fill-proj { height: 100%; background: linear-gradient(90deg, #388bfd, #79c0ff); border-radius: 3px; transition: width 0.5s ease; }
+  .bar-count { width: 64px; color: #8b949e; text-align: right; flex-shrink: 0; font-size: 0.72rem; }
+
+  .section-title { color: #8b949e; font-size: 0.72rem; text-transform: uppercase; letter-spacing: 1px; margin-bottom: 10px; margin-top: 16px; }
+  .section-title:first-child { margin-top: 0; }
+
+  .reset-btn { margin-top: 16px; background: none; border: 1px solid #30363d; color: #8b949e; padding: 8px 16px; border-radius: 6px; cursor: pointer; font-family: inherit; font-size: 0.8rem; display: block; width: 100%; transition: all 0.2s; }
+  .reset-btn:hover { border-color: #79c0ff; color: #79c0ff; }
+  .footer { color: #8b949e; font-size: 0.75rem; text-align: center; margin-top: 12px; }
+  .footer a { color: #79c0ff; text-decoration: none; }
+  .footer a:hover { text-decoration: underline; }
+</style>
+</head>
+<body>
+<h1>💾 cc-size</h1>
+<p class="subtitle">How much conversation history have you accumulated?</p>
+
+<div class="drop-zone" id="drop-zone">
+  <div style="font-size:2.5rem;margin-bottom:12px;">📁</div>
+  <div class="drop-text">
+    <strong>Drop your ~/.claude folder here</strong><br>
+    or click to select<br><br>
+    Reads file metadata only (no content).<br>
+    Nothing is uploaded.
+  </div>
+  <input type="file" id="file-input" webkitdirectory multiple accept=".jsonl">
+</div>
+
+<div class="result" id="result">
+  <div class="card">
+    <div class="card-title">History Summary</div>
+    <div class="stats-grid">
+      <div class="stat-item"><div class="stat-val" id="stat-total">—</div><div class="stat-lbl">total size</div></div>
+      <div class="stat-item"><div class="stat-val" id="stat-files">—</div><div class="stat-lbl">sessions</div></div>
+      <div class="stat-item"><div class="stat-val" id="stat-growth">—</div><div class="stat-lbl">per day (30d)</div></div>
+      <div class="stat-item"><div class="stat-val" id="stat-largest">—</div><div class="stat-lbl">largest file</div></div>
+    </div>
+    <div class="growth-badge" id="growth-badge">—</div>
+  </div>
+
+  <div class="card">
+    <div class="section-title">Monthly growth</div>
+    <div class="bar-chart" id="month-chart"></div>
+
+    <div class="section-title">By project (top 8)</div>
+    <div class="bar-chart" id="proj-chart"></div>
+  </div>
+
+  <button class="reset-btn" id="reset-btn">← Analyze another folder</button>
+</div>
+
+<div class="footer">
+  <a href="https://github.com/yurukusa/cc-size" target="_blank">cc-size</a> ·
+  Part of <a href="https://yurukusa.github.io/cc-toolkit/" target="_blank">cc-toolkit</a> · 106 free tools for Claude Code
+</div>
+
+<script>
+const dropZone = document.getElementById('drop-zone');
+const fileInput = document.getElementById('file-input');
+const resultEl = document.getElementById('result');
+const resetBtn = document.getElementById('reset-btn');
+
+dropZone.addEventListener('click', () => fileInput.click());
+dropZone.addEventListener('dragover', e => { e.preventDefault(); dropZone.classList.add('drag-over'); });
+dropZone.addEventListener('dragleave', () => dropZone.classList.remove('drag-over'));
+dropZone.addEventListener('drop', e => { e.preventDefault(); dropZone.classList.remove('drag-over'); processFiles(e.dataTransfer.files); });
+fileInput.addEventListener('change', () => processFiles(fileInput.files));
+resetBtn.addEventListener('click', () => { resultEl.classList.remove('visible'); dropZone.style.display = ''; fileInput.value = ''; });
+
+function humanSize(bytes) {
+  if (bytes >= 1024**3) return (bytes/1024**3).toFixed(1) + ' GB';
+  if (bytes >= 1024**2) return (bytes/1024**2).toFixed(1) + ' MB';
+  if (bytes >= 1024) return (bytes/1024).toFixed(1) + ' KB';
+  return bytes + ' B';
+}
+
+function projectName(webkitPath) {
+  // Extract project dir from path like ".claude/projects/PROJ/file.jsonl"
+  const parts = webkitPath.split('/');
+  const projIdx = parts.indexOf('projects');
+  if (projIdx >= 0 && parts[projIdx + 1]) {
+    const dir = parts[projIdx + 1];
+    const stripped = dir.replace(/^-home-[^-]+/, '').replace(/^-/, '');
+    return stripped || '~/ (home)';
+  }
+  return 'unknown';
+}
+
+function getMonth(file) {
+  const d = new Date(file.lastModified);
+  return `${d.getFullYear()}-${String(d.getMonth()+1).padStart(2,'0')}`;
+}
+
+async function processFiles(files) {
+  const jsonlFiles = Array.from(files).filter(f => {
+    const p = f.webkitRelativePath || f.name;
+    return p.endsWith('.jsonl') && !p.includes('/subagents/');
+  });
+  if (!jsonlFiles.length) { alert('No session files found.'); return; }
+  dropZone.style.display = 'none';
+
+  let totalBytes = 0, totalFiles = 0;
+  let largestSize = 0;
+  const byMonth = {}, byProj = {};
+  const now = new Date();
+  const thirtyAgo = now - 30*86400000;
+
+  for (const f of jsonlFiles) {
+    const size = f.size;
+    totalBytes += size;
+    totalFiles++;
+    if (size > largestSize) largestSize = size;
+
+    const month = getMonth(f);
+    byMonth[month] = (byMonth[month]||0) + size;
+
+    const proj = projectName(f.webkitRelativePath || f.name);
+    if (!byProj[proj]) byProj[proj] = 0;
+    byProj[proj] += size;
+  }
+
+  // 30-day growth
+  let last30 = 0;
+  for (const [month, bytes] of Object.entries(byMonth)) {
+    const [yr, mo] = month.split('-').map(Number);
+    if (new Date(yr, mo-1, 1) >= new Date(thirtyAgo)) last30 += bytes;
+  }
+  const dailyGrowth = last30 / 30;
+
+  document.getElementById('stat-total').textContent = humanSize(totalBytes);
+  document.getElementById('stat-files').textContent = totalFiles;
+  document.getElementById('stat-growth').textContent = humanSize(dailyGrowth);
+  document.getElementById('stat-largest').textContent = humanSize(largestSize);
+
+  // Growth projection
+  const daysTo10GB = (10*1024**3 - totalBytes) / dailyGrowth;
+  if (daysTo10GB > 0 && daysTo10GB < 3650) {
+    const d = new Date(now.getTime() + daysTo10GB*86400000);
+    document.getElementById('growth-badge').textContent = `At this rate → 10 GB by ${d.toISOString().slice(0,7)}`;
+  } else {
+    document.getElementById('growth-badge').textContent = `${totalFiles} session files · ${humanSize(totalBytes)} total`;
+  }
+
+  // Monthly chart
+  const months = Object.entries(byMonth).sort((a,b)=>a[0].localeCompare(b[0])).slice(-12);
+  const maxM = Math.max(...months.map(([,b])=>b));
+  const curMonth = `${now.getFullYear()}-${String(now.getMonth()+1).padStart(2,'0')}`;
+  document.getElementById('month-chart').innerHTML = months.map(([m,b]) =>
+    `<div class="bar-row">
+      <div class="bar-label">${m}</div>
+      <div class="bar-track"><div class="bar-fill-month" style="width:${(b/maxM*100).toFixed(1)}%"></div></div>
+      <div class="bar-count">${humanSize(b)}${m===curMonth?' *':''}</div>
+    </div>`
+  ).join('');
+
+  // Project chart
+  const projs = Object.entries(byProj).sort((a,b)=>b[1]-a[1]).slice(0,8);
+  const maxP = projs[0]?.[1]||1;
+  document.getElementById('proj-chart').innerHTML = projs.map(([name,bytes]) =>
+    `<div class="bar-row">
+      <div class="bar-label-wide">${name}</div>
+      <div class="bar-track"><div class="bar-fill-proj" style="width:${(bytes/maxP*100).toFixed(1)}%"></div></div>
+      <div class="bar-count">${humanSize(bytes)}</div>
+    </div>`
+  ).join('');
+
+  resultEl.classList.add('visible');
+}
+</script>
+</body>
+</html>

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "cc-size",
+  "version": "1.0.0",
+  "description": "How much conversation history have you accumulated? Total disk usage and growth rate of your Claude Code sessions.",
+  "type": "module",
+  "bin": {
+    "cc-size": "./cli.mjs"
+  },
+  "scripts": {
+    "start": "node cli.mjs"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "developer-tools",
+    "analytics",
+    "productivity"
+  ],
+  "author": "yurukusa",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}