About scrooge-stats
scrooge-stats is a skill for displaying session statistics. It is intended for users who need measured output-token counts and, when available, benchmark-based savings; it requires reporting the script output verbatim rather than recalculating figures.
Key features
- 01Run the stats script for a session ID
- 02Show measured output-token counts verbatim
- 03Include benchmark-based savings when available
- 04Append a one-line summary when requested
Use cases
- 01Review output-token statistics for a session
- 02Produce a compact, shareable stats summary
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ kir93/ scrooge-mode --skill scrooge-statsAfter installing, type/scrooge-statsin Claude Code to confirm it loaded.
Bundled filesLICENSEREADME.md
Details
From the project READMERun the stats script and show its output verbatim:
node "${CLAUDE_PLUGIN_ROOT}/hooks/scrooge-stats.js" --session-id "${CLAUDE_SESSION_ID}"
Append --share for a one-line summary. Report only what the script prints
(measured output tokens, plus a benchmark-based "(est)" savings figure when
available) — do not recompute or estimate tokens yourself. If the script is not
found (a host without the plugin files), say so rather than fabricating numbers.
On Codex installs the UserPromptSubmit hook (hooks/scrooge-activate.js)
intercepts the stats trigger and returns the figures directly, so this body
never runs there. It is the path for hosts (e.g. Claude in the editor) where the
hook's block payload is not surfaced to the user.