cc-file-churn 1.0.0

package/README.md

@@ -0,0 +1,60 @@
+# cc-file-churn
+
+Which files does Claude Code touch the most? Find the hotspots.
+
+```
+npx cc-file-churn
+```
+
+## What it does
+
+Scans all your `~/.claude/projects/` session transcripts and counts every `Edit`, `Write`, `Read`, `Grep`, and `Glob` tool call per file. Shows a ranked list with color-coded progress bars.
+
+## Example output
+
+```
+cc-file-churn — Most-touched files in your Claude Code sessions
+
+Scanned 755 session files · 2,219 unique files · 12,476 tool calls
+
+① ████████████████████ 933 total
+   ~/.claude/plans/staged-hatching-backus.md
+   669 writes  239 reads  25 searches
+
+② ██████████████░░░░░░ 671 total
+   ~/projects/dungeon-diablo/dungeon_game.py
+   70 writes  313 reads  288 searches
+
+③ ███████████░░░░░░░░░ 493 total
+   ~/schedule-app/index.html
+   215 writes  218 reads  60 searches
+```
+
+## Why this is interesting
+
+The #1 most-touched file in my 60 days: a planning file with 669 writes. #2: the game I spent 3 months building. #3: a schedule app I built in one session.
+
+Your highest-churn files reveal:
+- **Where the AI spends most effort** (vs where you think it does)
+- **Which files are becoming complexity magnets**
+- **Which projects actually got attention** (vs the ones that felt important)
+
+## Options
+
+```bash
+npx cc-file-churn              # Top 20 files by total activity
+npx cc-file-churn 10           # Top 10
+npx cc-file-churn --writes     # Rank by write frequency (most-modified)
+npx cc-file-churn --reads      # Rank by read frequency (most-referenced)
+npx cc-file-churn --days=7     # Only last 7 days
+npx cc-file-churn --project=my-app  # Filter to a specific project
+npx cc-file-churn --json       # JSON output for scripting
+```
+
+## Part of cc-toolkit
+
+One of 50 free tools for Claude Code users → [cc-toolkit](https://yurukusa.github.io/cc-toolkit/)
+
+## License
+
+MIT

package/cli.mjs

@@ -0,0 +1,182 @@
+#!/usr/bin/env node
+
+// cc-file-churn — Which files does Claude Code touch the most?
+// Scans ~/.claude/projects/ session transcripts, tallies Edit/Write/Read/Grep tool calls per file.
+// Zero dependencies. Works across all Claude Code projects.
+
+import { readdir, stat, open } from 'node:fs/promises';
+import { join, basename } from 'node:path';
+import { homedir } from 'node:os';
+
+// ── Config ──────────────────────────────────────────────────────
+
+const READ_TOOLS = new Set(['Read']);
+const WRITE_TOOLS = new Set(['Edit', 'Write', 'NotebookEdit']);
+const SEARCH_TOOLS = new Set(['Grep', 'Glob']);
+const ALL_TRACKED = new Set([...READ_TOOLS, ...WRITE_TOOLS, ...SEARCH_TOOLS]);
+
+const TAIL_BYTES = 4_194_304; // 4MB per file (faster than full scan)
+
+// ── Colors ──────────────────────────────────────────────────────
+
+const C = {
+  reset: '\x1b[0m', bold: '\x1b[1m', dim: '\x1b[2m',
+  red: '\x1b[31m', green: '\x1b[32m', yellow: '\x1b[33m',
+  blue: '\x1b[34m', cyan: '\x1b[36m', white: '\x1b[37m',
+  orange: '\x1b[38;5;208m',
+};
+
+function bar(n, max, width = 20) {
+  const filled = max > 0 ? Math.round((n / max) * width) : 0;
+  return C.cyan + '█'.repeat(filled) + C.dim + '░'.repeat(width - filled) + C.reset;
+}
+
+// ── File reading ─────────────────────────────────────────────────
+
+async function readChunk(filePath, maxBytes) {
+  const fh = await open(filePath, 'r');
+  try {
+    const { size } = await fh.stat();
+    const start = Math.max(0, size - maxBytes);
+    const buf = Buffer.alloc(size - start);
+    const { bytesRead } = await fh.read(buf, 0, buf.length, start);
+    return buf.toString('utf8', 0, bytesRead);
+  } finally {
+    await fh.close();
+  }
+}
+
+// ── Parse tool calls from jsonl chunk ───────────────────────────
+
+function parseChunk(chunk, fileMap, toolMap) {
+  const lines = chunk.split('\n');
+  for (const line of lines) {
+    if (!line.trim()) continue;
+    let d;
+    try { d = JSON.parse(line); } catch { continue; }
+    if (d.type !== 'assistant') continue;
+    for (const content of d?.message?.content ?? []) {
+      if (content?.type !== 'tool_use') continue;
+      const toolName = content.name;
+      if (!ALL_TRACKED.has(toolName)) continue;
+      const inp = content.input ?? {};
+      const path = inp.file_path ?? inp.path ?? '';
+      if (!path || typeof path !== 'string') continue;
+      // Normalize: remove absolute prefix up to home
+      const norm = path.replace(/^\/home\/[^/]+/, '~');
+      if (!fileMap.has(norm)) fileMap.set(norm, { r: 0, w: 0, s: 0 });
+      const e = fileMap.get(norm);
+      if (READ_TOOLS.has(toolName)) e.r++;
+      else if (WRITE_TOOLS.has(toolName)) e.w++;
+      else if (SEARCH_TOOLS.has(toolName)) e.s++;
+      toolMap.set(toolName, (toolMap.get(toolName) ?? 0) + 1);
+    }
+  }
+}
+
+// ── Find all jsonl files ─────────────────────────────────────────
+
+async function findJsonlFiles(projectFilter) {
+  const base = join(homedir(), '.claude', 'projects');
+  let dirs;
+  try { dirs = await readdir(base); } catch { return []; }
+  const files = [];
+  for (const dir of dirs) {
+    if (projectFilter && !dir.includes(projectFilter)) continue;
+    const dirPath = join(base, dir);
+    let entries;
+    try { entries = await readdir(dirPath); } catch { continue; }
+    for (const e of entries) {
+      if (!e.endsWith('.jsonl')) continue;
+      const fp = join(dirPath, e);
+      try {
+        const s = await stat(fp);
+        files.push({ fp, size: s.size, mtime: s.mtimeMs, project: dir });
+      } catch {}
+    }
+  }
+  return files;
+}
+
+// ── Main ─────────────────────────────────────────────────────────
+
+async function main() {
+  const args = process.argv.slice(2);
+  const topN = parseInt(args.find(a => a.match(/^\d+$/)) ?? '20');
+  const showWrites = args.includes('--writes') || args.includes('-w');
+  const showReads = args.includes('--reads') || args.includes('-r');
+  const showAll = args.includes('--all') || args.includes('-a');
+  const jsonOut = args.includes('--json');
+  const projectFilter = args.find(a => a.startsWith('--project='))?.split('=')[1];
+  const daysArg = args.find(a => a.startsWith('--days='))?.split('=')[1];
+  const sinceMs = daysArg ? Date.now() - parseInt(daysArg) * 86400_000 : 0;
+
+  const files = await findJsonlFiles(projectFilter);
+  if (!files.length) {
+    console.error('No Claude Code session files found.');
+    process.exit(1);
+  }
+
+  const filtered = sinceMs ? files.filter(f => f.mtime >= sinceMs) : files;
+
+  const fileMap = new Map();
+  const toolMap = new Map();
+  let processed = 0;
+
+  for (const f of filtered) {
+    try {
+      const chunk = await readChunk(f.fp, TAIL_BYTES);
+      parseChunk(chunk, fileMap, toolMap);
+      processed++;
+    } catch {}
+  }
+
+  // Build sorted list
+  const entries = [...fileMap.entries()].map(([path, c]) => ({
+    path, reads: c.r, writes: c.w, searches: c.s, total: c.r + c.w + c.s,
+  }));
+
+  // Filter mode
+  let display = showWrites ? entries.filter(e => e.writes > 0) :
+                showReads ? entries.filter(e => e.reads > 0) :
+                entries;
+  display.sort((a, b) => (showWrites ? b.writes - a.writes :
+                           showReads ? b.reads - a.reads :
+                           b.total - a.total));
+  display = display.slice(0, showAll ? 50 : topN);
+
+  if (jsonOut) {
+    console.log(JSON.stringify({ files_analyzed: processed, top: display }, null, 2));
+    return;
+  }
+
+  const maxVal = display[0]?.total ?? 1;
+  const totalOps = [...fileMap.values()].reduce((s, c) => s + c.r + c.w + c.s, 0);
+
+  console.log(`\n${C.bold}cc-file-churn${C.reset} — Most-touched files in your Claude Code sessions\n`);
+  console.log(`${C.dim}Scanned ${processed} session files · ${fileMap.size} unique files · ${totalOps} tool calls${daysArg ? ` (last ${daysArg}d)` : ''}${C.reset}\n`);
+
+  const rank = [C.yellow + '①', C.white + '②', C.dim + '③'];
+  display.forEach((e, i) => {
+    const medal = rank[i] ?? C.dim + `${String(i + 1).padStart(2)}`;
+    const shortPath = e.path.length > 60 ? '…' + e.path.slice(-59) : e.path;
+    const barVal = showWrites ? e.writes : showReads ? e.reads : e.total;
+    console.log(`${medal}${C.reset} ${bar(barVal, maxVal)} ${C.bold}${barVal}${C.reset} ${C.dim}total${C.reset}`);
+    console.log(`   ${C.cyan}${shortPath}${C.reset}`);
+    if (e.writes > 0 || e.reads > 0 || e.searches > 0) {
+      const parts = [];
+      if (e.writes > 0) parts.push(`${C.orange}${e.writes} writes${C.reset}`);
+      if (e.reads > 0) parts.push(`${C.green}${e.reads} reads${C.reset}`);
+      if (e.searches > 0) parts.push(`${C.dim}${e.searches} searches${C.reset}`);
+      console.log(`   ${parts.join('  ')}`);
+    }
+    console.log();
+  });
+
+  // Tool breakdown
+  const topTools = [...toolMap.entries()].sort((a, b) => b[1] - a[1]);
+  console.log(`${C.dim}Tool breakdown: ${topTools.map(([t, n]) => `${t}:${n}`).join(' · ')}${C.reset}\n`);
+  console.log(`${C.dim}Options: --writes (-w) write-heavy files · --reads (-r) read-heavy files · --days=7 last N days · --project=name filter project · --json JSON output${C.reset}\n`);
+}
+
+main().catch(e => { console.error(e.message); process.exit(1); });

package/index.html

@@ -0,0 +1,237 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>cc-file-churn — Which files does Claude Code touch the most?</title>
+<meta name="description" content="Find the hotspot files in your Claude Code sessions. Drag in your ~/.claude folder to rank files by Edit/Write/Read frequency.">
+<meta property="og:title" content="cc-file-churn — File activity ranking for Claude Code">
+<meta property="og:description" content="Which files does your AI keep coming back to? Ranks by writes, reads, and searches across all sessions.">
+<meta property="og:url" content="https://yurukusa.github.io/cc-file-churn/">
+<meta name="twitter:card" content="summary">
+<meta name="twitter:site" content="@yurukusa_dev">
+<style>
+* { margin: 0; padding: 0; box-sizing: border-box; }
+:root {
+  --bg: #0d1117; --surface: #161b22; --border: #30363d;
+  --text: #e6edf3; --muted: #8b949e;
+  --green: #56d364; --yellow: #f7c948; --orange: #ffa657;
+  --cyan: #58d8f0; --blue: #58a6ff; --red: #ff7b72;
+}
+body {
+  background: var(--bg); color: var(--text);
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Consolas, monospace;
+  min-height: 100vh; display: flex; flex-direction: column;
+  align-items: center; padding: 2rem 1rem;
+}
+.header { text-align: center; margin-bottom: 2rem; }
+.header h1 { font-size: 1.8rem; font-weight: 700; color: var(--orange); margin-bottom: 0.5rem; }
+.header p { color: var(--muted); font-size: 0.9rem; }
+.drop-zone {
+  width: 100%; max-width: 600px; border: 2px dashed var(--border);
+  border-radius: 12px; padding: 3rem 2rem; text-align: center;
+  cursor: pointer; transition: border-color 0.2s, background 0.2s;
+  margin-bottom: 2rem; background: var(--surface);
+}
+.drop-zone:hover, .drop-zone.drag-over { border-color: var(--orange); background: #1a1a0f; }
+.drop-zone h2 { font-size: 1.1rem; margin-bottom: 0.75rem; }
+.drop-zone p { color: var(--muted); font-size: 0.85rem; line-height: 1.5; }
+.drop-zone .icon { font-size: 2.5rem; margin-bottom: 1rem; }
+.drop-zone input[type="file"] { display: none; }
+.controls {
+  width: 100%; max-width: 700px; display: flex; gap: 0.5rem;
+  flex-wrap: wrap; margin-bottom: 1.5rem;
+}
+.filter-btn {
+  background: var(--surface); border: 1px solid var(--border);
+  border-radius: 6px; padding: 0.4rem 0.85rem; font-size: 0.8rem;
+  color: var(--muted); cursor: pointer; font-family: inherit;
+  transition: border-color 0.15s, color 0.15s;
+}
+.filter-btn.active { border-color: var(--orange); color: var(--orange); }
+.filter-btn:hover { border-color: var(--text); color: var(--text); }
+#results { width: 100%; max-width: 700px; display: none; }
+.meta { font-size: 0.8rem; color: var(--muted); margin-bottom: 1.5rem; text-align: center; }
+.file-row {
+  background: var(--surface); border: 1px solid var(--border);
+  border-radius: 8px; padding: 1rem 1.25rem; margin-bottom: 0.75rem;
+}
+.file-rank { display: flex; align-items: center; gap: 0.75rem; margin-bottom: 0.5rem; }
+.rank-num { font-size: 1.1rem; min-width: 1.5rem; }
+.file-path { font-size: 0.82rem; color: var(--cyan); font-family: Consolas, monospace; word-break: break-all; }
+.bar-container { margin-bottom: 0.5rem; }
+.bar-bg { height: 6px; border-radius: 3px; background: #21262d; overflow: hidden; }
+.bar-fill { height: 100%; border-radius: 3px; background: var(--orange); }
+.bar-label { display: flex; justify-content: space-between; font-size: 0.75rem; margin-top: 0.25rem; }
+.counts { display: flex; gap: 1rem; font-size: 0.78rem; flex-wrap: wrap; margin-top: 0.4rem; }
+.count-w { color: var(--orange); } .count-r { color: var(--green); } .count-s { color: var(--muted); }
+.summary-card {
+  background: var(--surface); border: 1px solid var(--border);
+  border-radius: 8px; padding: 1.25rem; text-align: center; margin-top: 1.5rem;
+}
+.s-title { font-size: 0.7rem; color: var(--muted); text-transform: uppercase; letter-spacing: 0.08em; margin-bottom: 1rem; }
+.s-stats { display: flex; justify-content: center; gap: 2.5rem; flex-wrap: wrap; }
+.s-stat .num { font-size: 1.5rem; font-weight: 700; color: var(--orange); display: block; }
+.s-stat .lbl { font-size: 0.75rem; color: var(--muted); }
+.footer { margin-top: 2rem; text-align: center; font-size: 0.8rem; color: var(--muted); }
+.footer a { color: var(--blue); text-decoration: none; margin: 0 0.5rem; }
+.btn {
+  background: var(--orange); color: #0d1117; border: none;
+  border-radius: 6px; padding: 0.6rem 1.5rem; font-size: 0.9rem;
+  font-weight: 600; cursor: pointer; margin-top: 1rem; font-family: inherit;
+}
+.btn:hover { opacity: 0.85; }
+</style>
+</head>
+<body>
+<div class="header">
+  <h1>cc-file-churn</h1>
+  <p>Which files does Claude Code touch the most?</p>
+</div>
+<div class="drop-zone" id="dropZone" onclick="document.getElementById('fi').click()">
+  <div class="icon">📁</div>
+  <h2>Drop your .claude folder here</h2>
+  <p>Or click to select it.<br>Your data stays local — nothing is uploaded.</p>
+  <input type="file" id="fi" webkitdirectory multiple>
+  <button class="btn" onclick="event.stopPropagation(); document.getElementById('fi').click()">
+    Select ~/.claude folder
+  </button>
+</div>
+<div class="controls" id="controls" style="display:none;">
+  <button class="filter-btn active" data-mode="total">All activity</button>
+  <button class="filter-btn" data-mode="writes">Most-modified</button>
+  <button class="filter-btn" data-mode="reads">Most-referenced</button>
+</div>
+<div id="results">
+  <div class="meta" id="metaLine"></div>
+  <div id="fileList"></div>
+  <div class="summary-card" id="summaryCard"></div>
+  <div class="footer">
+    <a href="https://github.com/yurukusa/cc-file-churn" target="_blank">GitHub</a> ·
+    <a href="https://yurukusa.github.io/cc-toolkit/" target="_blank">cc-toolkit (106 free tools)</a> ·
+    <span>Also: <code>npx cc-file-churn</code></span>
+  </div>
+</div>
+<div class="footer" id="footerMain">
+  <a href="https://github.com/yurukusa/cc-file-churn" target="_blank">GitHub</a> ·
+  <a href="https://yurukusa.github.io/cc-toolkit/" target="_blank">cc-toolkit</a> ·
+  <span>Part of 106 free tools for Claude Code</span>
+</div>
+<script>
+const READ_TOOLS = new Set(['Read']);
+const WRITE_TOOLS = new Set(['Edit', 'Write', 'NotebookEdit']);
+const SEARCH_TOOLS = new Set(['Grep', 'Glob']);
+const ALL_TRACKED = new Set([...READ_TOOLS, ...WRITE_TOOLS, ...SEARCH_TOOLS]);
+
+let allFiles = [];
+let currentMode = 'total';
+
+const dropZone = document.getElementById('dropZone');
+const fi = document.getElementById('fi');
+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(Array.from(e.dataTransfer.files)); });
+fi.addEventListener('change', e => processFiles(Array.from(e.target.files)));
+
+document.querySelectorAll('.filter-btn').forEach(btn => {
+  btn.addEventListener('click', () => {
+    document.querySelectorAll('.filter-btn').forEach(b => b.classList.remove('active'));
+    btn.classList.add('active');
+    currentMode = btn.dataset.mode;
+    renderFiles(allFiles);
+  });
+});
+
+async function processFiles(files) {
+  const jsonlFiles = files.filter(f => f.name.endsWith('.jsonl') && f.webkitRelativePath.includes('projects'));
+  if (!jsonlFiles.length) { alert('No session files found.\nSelect your .claude folder (not a subfolder).'); return; }
+  const fileMap = new Map();
+  for (const f of jsonlFiles) {
+    try {
+      const text = await readChunk(f, 4 * 1024 * 1024);
+      parseChunk(text, fileMap);
+    } catch {}
+  }
+  allFiles = [...fileMap.entries()].map(([path, c]) => ({
+    path, r: c.r, w: c.w, s: c.s, total: c.r + c.w + c.s
+  }));
+  const totalOps = allFiles.reduce((sum, e) => sum + e.total, 0);
+  document.getElementById('metaLine').textContent =
+    `${jsonlFiles.length} session files · ${allFiles.length} unique files · ${totalOps} tool calls`;
+  dropZone.style.display = 'none';
+  document.getElementById('footerMain').style.display = 'none';
+  document.getElementById('controls').style.display = 'flex';
+  document.getElementById('results').style.display = 'block';
+  renderFiles(allFiles);
+}
+
+async function readChunk(file, maxBytes) {
+  const start = Math.max(0, file.size - maxBytes);
+  return await file.slice(start).text();
+}
+
+function parseChunk(text, fileMap) {
+  for (const line of text.split('\n')) {
+    if (!line.trim()) continue;
+    let d; try { d = JSON.parse(line); } catch { continue; }
+    if (d.type !== 'assistant') continue;
+    for (const c of d?.message?.content ?? []) {
+      if (c?.type !== 'tool_use' || !ALL_TRACKED.has(c.name)) continue;
+      const path = c.input?.file_path ?? c.input?.path ?? '';
+      if (!path || typeof path !== 'string') continue;
+      const norm = path.replace(/^\/home\/[^/]+/, '~');
+      if (!fileMap.has(norm)) fileMap.set(norm, { r: 0, w: 0, s: 0 });
+      const e = fileMap.get(norm);
+      if (READ_TOOLS.has(c.name)) e.r++;
+      else if (WRITE_TOOLS.has(c.name)) e.w++;
+      else if (SEARCH_TOOLS.has(c.name)) e.s++;
+    }
+  }
+}
+
+function renderFiles(files) {
+  const sorted = [...files].sort((a, b) =>
+    currentMode === 'writes' ? b.w - a.w :
+    currentMode === 'reads' ? b.r - a.r : b.total - a.total
+  ).slice(0, 25);
+
+  const maxVal = sorted[0]?.[currentMode === 'writes' ? 'w' : currentMode === 'reads' ? 'r' : 'total'] ?? 1;
+  const medals = ['🥇', '🥈', '🥉'];
+  const list = document.getElementById('fileList');
+  list.innerHTML = sorted.map((e, i) => {
+    const val = currentMode === 'writes' ? e.w : currentMode === 'reads' ? e.r : e.total;
+    const pct = (val / maxVal * 100).toFixed(0);
+    const short = e.path.length > 65 ? '…' + e.path.slice(-64) : e.path;
+    const countParts = [];
+    if (e.w > 0) countParts.push(`<span class="count-w">${e.w} writes</span>`);
+    if (e.r > 0) countParts.push(`<span class="count-r">${e.r} reads</span>`);
+    if (e.s > 0) countParts.push(`<span class="count-s">${e.s} searches</span>`);
+    return `<div class="file-row">
+      <div class="file-rank">
+        <span class="rank-num">${medals[i] ?? '#' + (i+1)}</span>
+        <span style="font-size:1.1rem;font-weight:700;color:var(--orange)">${val}</span>
+      </div>
+      <div class="file-path">${short}</div>
+      <div class="bar-container">
+        <div class="bar-bg"><div class="bar-fill" style="width:${pct}%"></div></div>
+        <div class="bar-label"><span>${currentMode}</span><span style="color:var(--muted)">${pct}%</span></div>
+      </div>
+      <div class="counts">${countParts.join('')}</div>
+    </div>`;
+  }).join('');
+
+  const totalWrites = files.reduce((s, e) => s + e.w, 0);
+  const totalReads = files.reduce((s, e) => s + e.r, 0);
+  const topFile = sorted[0];
+  document.getElementById('summaryCard').innerHTML = `
+    <div class="s-title">Summary</div>
+    <div class="s-stats">
+      <div class="s-stat"><span class="num">${files.length}</span><span class="lbl">unique files</span></div>
+      <div class="s-stat"><span class="num" style="color:var(--orange)">${totalWrites}</span><span class="lbl">total writes</span></div>
+      <div class="s-stat"><span class="num" style="color:var(--green)">${totalReads}</span><span class="lbl">total reads</span></div>
+      <div class="s-stat"><span class="num">${topFile ? topFile.total : 0}</span><span class="lbl">max activity (#1)</span></div>
+    </div>`;
+}
+</script>
+</body>
+</html>

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "cc-file-churn",
+  "version": "1.0.0",
+  "description": "Which files does Claude Code touch the most? Ranks files by Edit/Write/Read frequency across all sessions.",
+  "main": "cli.mjs",
+  "bin": {
+    "cc-file-churn": "./cli.mjs"
+  },
+  "scripts": {
+    "start": "node cli.mjs"
+  },
+  "keywords": [
+    "claude-code",
+    "claude",
+    "ai",
+    "file-churn",
+    "developer-tools",
+    "cli",
+    "productivity"
+  ],
+  "author": "yurukusa",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  }
+}