PluginPartly tested (needs an account)

See where your Claude Code usage goes

Session Report

Anthropic's plugin turns your saved Claude Code sessions into an HTML report of token use by project, skill and prompt, so you can spot costly habits.

Works with
Claude Code
Good for
Everyone

What it does

Claude Code keeps a record of every session on your computer, in a folder called ~/.claude/projects. This Anthropic plugin reads those records and builds one web page (an HTML file). The page shows how many tokens you used, in which projects, and by which skills and helper agents (subagents). It also shows how well the cache worked and which single requests cost the most.

A token is the small piece of text the AI counts when it measures use. The cache is Claude's short-term store of text it has already read. The skill treats a cache rate under 85 percent as worth a closer look.

When you ask for a report, Claude runs a small script that comes with the plugin (analyze-sessions.mjs) with the node command. Claude asks the script for the last 7 days unless you name another range. The script writes a summary to /tmp/session-report.json. Claude then copies a ready-made page template into the folder you are working in, named like session-report-20261017-0930.html, and pastes the summary into it.

Last, Claude adds 3 to 5 one-line findings and 1 to 4 tips. A finding might be that one project used 40 percent of your week, or that one prompt alone used more than 2 percent.

The counting happens on your computer. The script only reads local files and has no code that sends data anywhere. Some things still matter for privacy:

  • The summary keeps short snippets of your own prompts, up to 240 characters each, from every project. It has snippets of your costliest prompts, of the prompts around them, and of prompts near cache breaks.
  • Claude reads that summary to write the findings, so it goes to the model like anything else in a chat.
  • The finished page holds those snippets too. It also shows your full ~/.claude/projects path (which includes your computer user name), your project folder names and session IDs.
  • When you open the page, it loads a font from Google Fonts.

Check the page before you share it with anyone.

The plugin has no account, key or settings. It works only with Claude Code's own session files, not with Codex or Gemini CLI.

Who it is for

Claude Code users who want to know where their usage goes: which projects, skills, helper agents and single requests cost the most. With that, they can change habits before they hit a limit.

Example prompts

  • "Make a session report for the last 7 days."
  • "Make a session report for the last 24 hours."
  • "Make a session report for the last 30 days and tell me which project used the most tokens."
  • "Make a session report for all time."
  • "Look at my session report and suggest two habits that would cut my usage."

How to install

claude plugin install session-report@claude-plugins-official

How to use it

Ask in Claude Code: Make a session report for the last 7 days. It saves an HTML file in your current folder and tells you the file name.

Check it works

  1. Ask for a report, for example "Make a session report for the last 7 days."
  2. In the normal mode, Claude Code asks you to approve some steps: the node command, the summary file in /tmp, the copy of the template and the edit of the HTML file. Approve them.
  3. When it is done, Claude tells you the path of the saved file, named like session-report-20261017-0930.html. It does not open the file for you.
  4. Open that file in your browser. You should see a total at the top, tables by project and by skill, and the findings box.

Common problems

  • The node command is not found — the script does not start — install Node.js, because the skill runs node analyze-sessions.mjs.
  • The report looks almost empty — few numbers on the page — the default range is the last 7 days. Ask for 30 days or all time instead.
  • A fresh computer has nothing to report — the page is empty — this is expected when ~/.claude/projects has no saved sessions yet. Use Claude Code for a while, then make the report again.
  • The report is empty although you use Claude Code a lot — you set CLAUDE_CONFIG_DIR to move your config folder — the script always reads ~/.claude/projects. Ask Claude to run the script with --dir <your-config-folder>/projects.
  • Install fails on a new computer — Claude Code does not know claude-plugins-official — a fresh Claude Code has no official plugin directory until its first interactive session. Open Claude Code once, or run claude plugin marketplace add anthropics/claude-plugins-official, then install again.

What to watch out for

  • Reads every saved session transcript in ~/.claude/projects, from all your projects (analyze-sessions.mjs)
  • The report holds short snippets of your own prompts from every project, and Claude reads them to write the findings; do not share the HTML file without checking it
  • The report also shows your home-folder path (which includes your computer user name), your project folder names and session IDs (analyze-sessions.mjs)
  • Runs a Node.js script with the node command, so Node.js must be installed
  • Writes /tmp/session-report.json and a new HTML file into the folder you are working in (SKILL.md)
  • The report page loads a font from Google Fonts when you open it in a browser (template.html)
  • The script always reads ~/.claude/projects and ignores CLAUDE_CONFIG_DIR; if you moved your config folder, the report is empty unless Claude runs it with --dir (analyze-sessions.mjs)

Licence and author

Licence
Apache-2.0
Author
Anthropic
Source code
github.com/anthropics/claude-plugins-official

How we tested it

We installed it on an empty test computer on 16 Oct 2026. Partly tested: installed in a clean test system, but its main features need an account or key we did not use.

Test level

We did not make a report, because the clean container has no saved sessions. Not yet used on real work.

Technical details of the test
Date
16 Oct 2026
Method
In a clean container with no account we added Anthropic's official plugin directory with claude plugin marketplace add anthropics/claude-plugins-official, then installed session-report (version ea10b213686c) with the Claude Code command line (Claude Code 2.1.296).

Checked again on 17 Oct 2026

Alternatives

  • claude-mem — keeps memory between sessions; it does not count tokens.
  • cc-safety-net — blocks risky commands; it does not report usage.

FAQ

Does it send my sessions anywhere? The analysis script only reads local files. Claude then reads its summary, which includes short snippets of your prompts, to write the findings.

Can I share the report with my team? Check it first. The page holds snippets of your prompts from every project. It also shows your home-folder path (with your computer user name), your project folder names and session IDs.

Does it work with Codex or Gemini CLI? No. It reads Claude Code's own session files in ~/.claude/projects.

Does it cost anything? It needs no account or key. Writing the findings uses a little of your normal Claude usage.

Sources