Caveman Stats

by juliusbrussee2e08b9177c07No licenseListed Oct 8, 2026Updated Oct 8, 2026

Show recorded output and cache-read token usage and mode attribution for the current Claude Code session, or locate the host's native usage report. Trigger: /caveman-stats.

Instructions onlyData & Analytics
AI-generated overview

Reports recorded token usage and mode attribution for the current Claude Code session, or points to a host's native usage report.

What it does
This skill prints the usage report supplied by the Claude Code caveman-mode-tracker hook verbatim in a fenced code block, without recalculating numbers. The report covers recorded output and cache-read tokens, response counts, and mode attribution where available. In Gemini CLI it directs users to the built-in /stats commands, and in other hosts it points to a native usage report or states that session usage is unavailable. It also documents aggregation flags and states that savings cannot be inferred.
When to use it
Use it when someone wants to see token usage or mode attribution for the current Claude Code session. It is also relevant when a user on Gemini CLI or another host asks for session usage statistics and needs to be pointed to the native report.
Requirements
Runs in Claude Code with the caveman-mode-tracker hook and its stats script installed; no scripts ship with this skill. Gemini CLI users need the built-in /stats commands. No credentials or network access are described.

In Claude Code, src/hooks/caveman-mode-tracker.js runs src/hooks/caveman-stats.js on /caveman-stats and supplies its report through hookSpecificOutput.additionalContext. Print that report verbatim inside a fenced code block, as the hook instructs. Do not calculate or add numbers yourself.

In Gemini CLI, direct the user to /stats model for current session token usage or /stats session for session statistics. Gemini custom commands are prompts; they cannot invoke the built-in command or read its live session metrics. Never read Claude Code transcripts as Gemini usage. In other hosts, use a native usage report if one is available; otherwise say that current session usage is unavailable. The Claude reader and its lifetime history apply only to Claude Code. Savings remain unknown in every host without a measured comparison.

The report shows recorded output and cache-read tokens, response counts, and mode attribution where available. Savings are unknown: the transcript has no measured comparison without Caveman. Do not infer saved tokens, percentages, dollars, rule overhead, or a net result from output counts or the current mode.

--all and --since 7d aggregate the latest recorded output count per session. --share reports observed usage with savings unknown. Historical est_saved_* fields are ignored; their original history rows remain on disk. The statusline shows the active mode without the retired savings badge.

Original/current memory-file pairs are reported by their measured byte sizes. Those file-size differences do not establish provider token or billing savings. See docs/HONEST-NUMBERS.md.

Source and attribution

Source:juliusbrussee/cavemaninplugins/caveman/skills/caveman-statsat commit2e08b91

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal