ClaudeCodeMod

All shelves / Mods / Review

repo-heatmap

By promptadvisers

repo-heatmap is a Claude Code review mod by promptadvisers.

Opens a map of the project's files, each area sized by the file, that lights up as Claude reads, searches, and edits them, and marks failed operations.

Draws

Install

The marketplace name is claude-mods-kit.

In your shell
claude plugin marketplace add promptadvisers/claude-mods-starter-kit --scope user
claude plugin install repo-heatmap@claude-mods-kit --scope user
Open the repo

It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.

Version
0.1.0
Repo stars
21
Last change
2026-10-02

What it can reach

  • Draws in the session
  • Sees tool calls

Release 1.0.0, checked with Claude Code 2.1.287 on macOS. Add the marketplace first, then start a fresh Claude Code session after installing. For one project, the guide gives the same lines with --scope project, run from that project's folder. To try it in one terminal session, run bash scripts/try.sh repo-heatmap from the downloaded kit. Open it with /heatmap open before the work starts; /heatmap size lines, /heatmap rescan, /heatmap reset, and /heatmap close are the other controls. Closing the pane hides it, and it keeps tracking. It tracks only what it sees during this session. A bright file is not proof of importance or a bug, and some shell activity is inferred and may not map perfectly. To unload it, run claude plugin disable repo-heatmap@claude-mods-kit --scope user and start a fresh session.

The marketplace, claude-mods-kit, holds the starter kit's ten mods, terminal-pet among them. Add promptadvisers/claude-mods-starter-kit. This one installs on its own. Seeing where Claude looks is why this page files it under review. filetree draws an IDE-style file tree beside the transcript that lights up what Claude reads, writes, and commits. glowup draws a side pane of changed files with their diffs, subagents, and context use. This one is a treemap of the whole project, colored by what Claude did to each file. In the source, the pane is opened with $.ui.open and drawn as a Pane render, a file's area is its lines by default or its bytes with /heatmap size bytes, and the file list comes from git ls-files, or from a walk of the folder outside git.

Demo

The opening of the Repo Heatmap guide in the starter kit: it draws a map of the project's files whose areas reflect size and whose colors react to reads, searches, edits, and failed operations; the install lines and the try.sh line; and the controls /heatmap open, size lines, rescan, reset, and close. The kit has no picture of the mod itself.
Screenshot of the author's GitHub page.

What it hooks into

  • session.startWhen a session starts
  • command.runWhen you run its slash command/heatmap
  • tool.callAround a tool call, where it can hold one
  • ui.renderDraws into the sessionPane
  • ui.closeWhen its pane closes

Read from the on() calls in its hook modules. Open its source under Files to check what each one does.

Slash commands 1

  • /heatmapRepo Heatmap: a live treemap of the repo that lights up as Claude reads, searches and edits

Files

The author's README and source, 4 files. They load when you open them.

Facts

Author
promptadvisers
Category
Review
Marketplace
claude-mods-kit
Repo
promptadvisers/claude-mods-starter-kit
Folder
plugins/repo-heatmap
Version
0.1.0
Repo stars
21
Last change
2026-10-02
Language
JavaScript
Files
7

Other mods in Review

flight-recorderpromptadvisersOpens a timeline of each turn: model requests, tool calls, and helper agents as lanes over time, so you see what ran alongside what, with an estimated cost.output-traypromptadvisersCollects the new files Claude creates during the session in a side panel, with Copy path, and Open and Reveal in Finder on macOS.changes-receiptpromptadvisersOpens a receipt of the files created, edited, and deleted in a tracked turn, with failed attempts listed apart from the changes that worked.assumption-ledgerDannyMac180Gives Claude a tool to note what it assumed, decided, or chose not to do, and lists them above the prompt when the turn ends, with Do it on each skipped fix.next-steps-supervisorDannyMac180After a turn that changed something, has a fork of the chat judge whether the work met the goal, and draws its verdict and next-step buttons above the prompt.huhomeerdvrnOpens Claude's last answer in a sidebar when you type /huh, rewritten by Haiku for reading: a short summary up top, clear headings, every fact and command kept.plain-replycharlie947Grades each reply for length, long sentences, and jargon in a band above the prompt. Over your bar, Say it simpler puts a rewrite request in the prompt box.prompt-coachmishgoldenbergBefore a vague prompt is sent, has a small model suggest a sharper one in a question dialog, and you pick Send improved, Send mine, or Edit.changesmishgoldenbergOpens a pane of every file Claude created or edited this session with +/- counts from git, and one-click why?, summarize all, and self-review.review-inboxSummerRiversoundDraws a band above the prompt for the pull requests waiting on you, and a drawer of them, each summarized in plain language, with your own PRs and your issues.creation-logUginimOpens a pane of the new files Claude wrote and the links it published, grouped by session, with Open, Show in folder, and Copy path on each.edit-diff-logUginimOpens a pane of every file edit Claude made, each with its unified diff, grouped by session and kept across sessions, for files outside git too.
All 145 in Review