cc-tool-mix 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 yurukusa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,66 @@
+# cc-tool-mix
+
+> Which tools does Claude Code use most in your sessions?
+
+Break down your tool usage across all Claude Code sessions — Bash, Read, Edit, Grep, Task, and more.
+
+```
+npx cc-tool-mix
+```
+
+## Output
+
+```
+⚒  cc-tool-mix — Claude Code tool usage breakdown
+   141,600 total tool calls across all projects
+
+Category Breakdown
+  File Ops      ████████░░░░░░░░░░░░   41.4%  58,608
+  Shell         ████████░░░░░░░░░░░░   37.5%  53,114
+  Search        ██░░░░░░░░░░░░░░░░░░   11.0%  15,591
+  Web           █░░░░░░░░░░░░░░░░░░░    2.8%   3,909
+  AI Agents     ░░░░░░░░░░░░░░░░░░░░    2.2%   3,091
+
+Top Tools
+  Bash                ████████░░░░░░░░░░░░   37.5%  53,114
+  Read                █████░░░░░░░░░░░░░░░   25.6%  36,287
+  Edit                ██░░░░░░░░░░░░░░░░░░   11.8%  16,746
+  Grep                ██░░░░░░░░░░░░░░░░░░    9.0%  12,798
+  Write               █░░░░░░░░░░░░░░░░░░░    3.9%   5,575
+
+Insight
+  Heavy Bash user (38%) — consider Grep/Glob for searches
+  Top tool: Bash (37.5%)
+```
+
+## Options
+
+```
+npx cc-tool-mix                  # full breakdown
+npx cc-tool-mix --project        # per-project top tool
+npx cc-tool-mix --top=10         # show only top 10 tools
+npx cc-tool-mix --json           # JSON output (pipe to other tools)
+```
+
+## Browser version
+
+No install: [yurukusa.github.io/cc-tool-mix](https://yurukusa.github.io/cc-tool-mix/)
+
+Drop your `~/.claude` folder to see your breakdown instantly.
+
+## Categories
+
+| Category  | Tools |
+|-----------|-------|
+| File Ops  | Read, Write, Edit, MultiEdit |
+| Shell     | Bash |
+| Search    | Grep, Glob |
+| AI Agents | Task, TaskOutput, Agent |
+| Web       | WebFetch, WebSearch |
+| UI / Flow | ExitPlanMode, AskUserQuestion |
+
+## Zero dependencies
+
+Reads directly from `~/.claude/projects/` — no network, no auth, no tracking.
+
+MIT License · [cc-toolkit](https://yurukusa.github.io/cc-toolkit/) · 48 free tools

package/cli.mjs

@@ -0,0 +1,189 @@
+#!/usr/bin/env node
+
+// cc-tool-mix — See which tools Claude Code uses most in your sessions.
+// Zero dependencies. Reads ~/.claude/projects/ session transcripts.
+
+import { readdir, stat, open, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+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', magenta: '\x1b[35m',
+  white: '\x1b[37m',
+};
+
+// Tool categories
+const CATEGORIES = {
+  'File Ops':    ['Read', 'Write', 'Edit', 'MultiEdit', 'NotebookEdit'],
+  'Search':      ['Grep', 'Glob'],
+  'Shell':       ['Bash'],
+  'AI Agents':   ['Task', 'TaskOutput', 'TaskStop', 'Agent', 'SendMessage'],
+  'Web':         ['WebFetch', 'WebSearch'],
+  'UI / Flow':   ['ExitPlanMode', 'EnterPlanMode', 'AskUserQuestion', 'Skill'],
+  'Other':       [],
+};
+
+function catOf(name) {
+  for (const [cat, tools] of Object.entries(CATEGORIES)) {
+    if (cat === 'Other') continue;
+    if (tools.includes(name)) return cat;
+  }
+  return 'Other';
+}
+
+function bar(pct, width = 30, char = '█') {
+  const filled = Math.round(pct * width);
+  return char.repeat(filled) + '░'.repeat(width - filled);
+}
+
+function catColor(cat) {
+  const m = { 'File Ops': C.cyan, 'Search': C.blue, 'Shell': C.yellow,
+    'AI Agents': C.magenta, 'Web': C.green, 'UI / Flow': C.dim, 'Other': C.dim };
+  return m[cat] || C.reset;
+}
+
+async function* walkJsonl(dir) {
+  let entries;
+  try { entries = await readdir(dir, { withFileTypes: true }); }
+  catch { return; }
+  for (const e of entries) {
+    const full = join(dir, e.name);
+    if (e.isDirectory()) yield* walkJsonl(full);
+    else if (e.isFile() && e.name.endsWith('.jsonl')) yield full;
+  }
+}
+
+async function parseFile(path, tools, perProject, projectKey) {
+  let text;
+  try { text = await readFile(path, 'utf8'); }
+  catch { return; }
+
+  for (const line of text.split('\n')) {
+    if (!line.trim()) continue;
+    let obj;
+    try { obj = JSON.parse(line); } catch { continue; }
+
+    if (obj.type !== 'assistant') continue;
+    const content = obj.message?.content;
+    if (!Array.isArray(content)) continue;
+
+    for (const c of content) {
+      if (c?.type !== 'tool_use') continue;
+      const name = c.name || 'unknown';
+      tools[name] = (tools[name] || 0) + 1;
+      if (perProject) {
+        perProject[projectKey] = perProject[projectKey] || {};
+        perProject[projectKey][name] = (perProject[projectKey][name] || 0) + 1;
+      }
+    }
+  }
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  const showJson    = args.includes('--json');
+  const showProject = args.includes('--project') || args.includes('-p');
+  const topN        = parseInt(args.find(a => a.startsWith('--top='))?.split('=')[1] || '20');
+
+  const claudeDir = join(homedir(), '.claude', 'projects');
+  let projDirs;
+  try { projDirs = await readdir(claudeDir, { withFileTypes: true }); }
+  catch { console.error('No ~/.claude/projects found'); process.exit(1); }
+
+  const tools = {};
+  const perProject = showProject ? {} : null;
+
+  for (const d of projDirs) {
+    if (!d.isDirectory()) continue;
+    const projPath = join(claudeDir, d.name);
+    const key = d.name.replace(/^-home-[^-]+-/, '').replace(/-/g, '/');
+    for await (const jsonlPath of walkJsonl(projPath)) {
+      await parseFile(jsonlPath, tools, perProject, key);
+    }
+  }
+
+  const total = Object.values(tools).reduce((s, n) => s + n, 0);
+  if (total === 0) { console.log('No tool usage data found.'); return; }
+
+  const sorted = Object.entries(tools).sort((a, b) => b[1] - a[1]).slice(0, topN);
+
+  // Category aggregation
+  const catTotals = {};
+  for (const [name, count] of Object.entries(tools)) {
+    const cat = catOf(name);
+    catTotals[cat] = (catTotals[cat] || 0) + count;
+  }
+  const sortedCats = Object.entries(catTotals).sort((a, b) => b[1] - a[1]);
+
+  if (showJson) {
+    console.log(JSON.stringify({ total, tools: Object.fromEntries(sorted), categories: Object.fromEntries(sortedCats) }, null, 2));
+    return;
+  }
+
+  console.log(`\n${C.bold}⚒  cc-tool-mix${C.reset} — Claude Code tool usage breakdown`);
+  console.log(`${C.dim}   ${total.toLocaleString()} total tool calls across all projects${C.reset}\n`);
+
+  // Category summary
+  console.log(`${C.bold}Category Breakdown${C.reset}`);
+  for (const [cat, count] of sortedCats) {
+    const pct = count / total;
+    const col = catColor(cat);
+    console.log(`  ${col}${cat.padEnd(12)}${C.reset}  ${bar(pct, 20)}  ${(pct * 100).toFixed(1).padStart(5)}%  ${C.dim}${count.toLocaleString()}${C.reset}`);
+  }
+
+  // Top tools
+  console.log(`\n${C.bold}Top Tools${C.reset}`);
+  for (const [name, count] of sorted) {
+    const pct = count / total;
+    const cat = catOf(name);
+    const col = catColor(cat);
+    console.log(`  ${col}${name.padEnd(18)}${C.reset}  ${bar(pct, 20)}  ${(pct * 100).toFixed(1).padStart(5)}%  ${C.dim}${count.toLocaleString()}${C.reset}`);
+  }
+
+  // Insight
+  const topTool = sorted[0];
+  const bashPct = (tools['Bash'] || 0) / total;
+  const searchPct = ((tools['Grep'] || 0) + (tools['Glob'] || 0)) / total;
+  const filePct = ((tools['Read'] || 0) + (tools['Write'] || 0) + (tools['Edit'] || 0)) / total;
+  const agentPct = ((tools['Task'] || 0) + (tools['Agent'] || 0)) / total;
+
+  console.log(`\n${C.bold}Insight${C.reset}`);
+  if (bashPct > 0.35) {
+    console.log(`  ${C.yellow}Heavy Bash user${C.reset} (${(bashPct*100).toFixed(0)}%) — consider Grep/Glob for searches`);
+  } else if (searchPct > 0.15) {
+    console.log(`  ${C.cyan}Search-driven${C.reset} (${(searchPct*100).toFixed(0)}% Grep+Glob) — efficient file discovery`);
+  }
+  if (agentPct > 0.1) {
+    console.log(`  ${C.magenta}Subagent-heavy${C.reset} (${(agentPct*100).toFixed(0)}%) — parallel workflows active`);
+  }
+  if (filePct > 0.5) {
+    console.log(`  ${C.cyan}File-ops focused${C.reset} (${(filePct*100).toFixed(0)}%) — read-edit-write cycle dominant`);
+  }
+  console.log(`  ${C.dim}Top tool: ${topTool[0]} (${(topTool[1]/total*100).toFixed(1)}%)${C.reset}`);
+
+  // Per-project breakdown
+  if (showProject && perProject) {
+    console.log(`\n${C.bold}Per-Project Top Tool${C.reset}`);
+    const projSorted = Object.entries(perProject)
+      .map(([proj, t]) => {
+        const tot = Object.values(t).reduce((s, n) => s + n, 0);
+        const top = Object.entries(t).sort((a, b) => b[1] - a[1])[0];
+        return { proj, tot, top };
+      })
+      .filter(x => x.tot > 10)
+      .sort((a, b) => b.tot - a.tot)
+      .slice(0, 15);
+
+    for (const { proj, tot, top } of projSorted) {
+      const pct = top[1] / tot;
+      const col = catColor(catOf(top[0]));
+      console.log(`  ${C.dim}${proj.slice(0, 30).padEnd(30)}${C.reset}  ${col}${top[0].padEnd(10)}${C.reset}  ${(pct*100).toFixed(0).padStart(3)}%  ${C.dim}${tot.toLocaleString()} calls${C.reset}`);
+    }
+  }
+
+  console.log('');
+}
+
+main().catch(e => { console.error(e.message); process.exit(1); });

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "cc-tool-mix",
+  "version": "1.0.0",
+  "description": "See which tools Claude Code uses most in your sessions — break down by category and project.",
+  "bin": {
+    "cc-tool-mix": "cli.mjs"
+  },
+  "type": "module",
+  "keywords": [
+    "claude-code",
+    "claude",
+    "ai",
+    "tools",
+    "usage",
+    "analytics",
+    "productivity",
+    "developer-tools"
+  ],
+  "author": "yurukusa",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yurukusa/cc-tool-mix.git"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "cli.mjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "prepublishOnly": "node --check cli.mjs"
+  }
+}