cc-read

Which files does Claude Code read most? dungeon_game.py was read 6,723 times. .py leads at 34.3% of all reads. 4 files hit the Hall of Fame (1,000+ reads each).

Top files, extensions, and projects from your Claude Code session transcripts.

npx cc-read

No install. No dependencies.

What it shows

• Most-read files — ranked bar chart (top 15)
• Hall of Fame — files read 1,000+ times
• By extension — .py, .gd, .md, .html, .yaml breakdown
• By project — which projects generated the most file reads
• Overview — total reads, unique files, top file & extension

Output

  cc-read — Most-Read Files
  ════════════════════════════════════════

  ▸ Overview
    Total Read calls:   36,973
    Unique files read:  4,512
    Most-read file:     dungeon_game.py (6,723×)
    Top extension:      .py (34.3%)
    Hall of Fame (1k+): 4 files

  ▸ Most-read files (top 15)
    dungeon_game.py                ██████████████  6,723  ★
    index.html                     ███░░░░░░░░░░░  1,639  ★
    dungeon.gd                     ███░░░░░░░░░░░  1,373  ★
    main_pygame.py                 ██░░░░░░░░░░░░  1,174  ★
    game_main.gd                   ██░░░░░░░░░░░░    907
    ...

  ▸ By extension
    .py         ████████████████  34.3%
    .gd         █████████░░░░░░░  19.9%
    .md         ████████░░░░░░░░  16.8%
    .png        ███░░░░░░░░░░░░░   7.2%
    .html       ███░░░░░░░░░░░░░   5.5%

  ▸ Hall of Fame — read 1,000+ times
    ★ dungeon_game.py — read 6,723 times
    ★ index.html — read 1,639 times
    ★ dungeon.gd — read 1,373 times
    ★ main_pygame.py — read 1,174 times

Options

npx cc-read          # terminal output
npx cc-read --json   # JSON output for scripting

JSON output

{
  "version": "1.0.0",
  "totalReads": 36973,
  "uniqueFiles": 4512,
  "topFile": { "name": "dungeon_game.py", "count": 6723 },
  "topExtension": { "ext": ".py", "count": 12683 },
  "byFile": [...],
  "byExtension": [...],
  "byProject": [...]
}

Browser version

Try it without installing: yurukusa.github.io/cc-read

Drag-drop your ~/.claude/projects/ folder (or any subfolder) to analyze.

How it works

Reads ~/.claude/projects/**/*.jsonl session transcripts and extracts every Read tool call. Aggregates by filename, extension, and project path. Zero external dependencies.

Part of cc-toolkit — 67 tools for understanding your Claude Code sessions.