Skip to content

yurukusa/cc-read

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 

Repository files navigation

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.

About

Which files does Claude Code read most? Top files, extensions, and projects from session transcripts.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors