# caveman-stats

> Claude/Codex skill by [@juliusbrussee](https://omgskills.com/library/juliusbrussee/index.md) · 113k stars · 379k installs · Updated 2026-10-18

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.

Tags: ai, anthropic, caveman, claude, claude-code, llm, meme, prompt-engineering, skill, tokens

## Install

```sh
git clone https://github.com/JuliusBrussee/caveman /tmp/caveman && ln -s /tmp/caveman/skills/caveman-stats ~/.claude/skills/caveman-stats
```

## From README

In Claude Code, src/hooks/caveman-mode-tracker.js resolves src/hooks/caveman-stats.js next to itself and runs it on /caveman-stats. The hook does not block the prompt: it supplies the report through hookSpecificOutput.additionalContext with an instruction to print it verbatim inside a fenced code block. Do exactly that, and do not calculate, recompute or re-round the numbers yourself. In Gemini CLI, direct the user to /stats model for current session token 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 . In other hosts, use a native report if one is available; otherwise say that current session is unavailable. The Claude reader and its lifetime history apply only to Claude Code. Savings remain unknown in every host without a measured comparison.

## Links

- HTML page: https://omgskills.com/library/juliusbrussee/caveman/caveman-stats/
- GitHub: https://github.com/JuliusBrussee/caveman
- Author: [@juliusbrussee](https://omgskills.com/library/juliusbrussee/index.md)

## More from this repo

- [cavecrew](https://omgskills.com/library/juliusbrussee/caveman/cavecrew/index.md) — When to delegate to \`cavecrew-investigator\` (locate code), \`cavecrew-builder\` (1-2 file edit) or \`cavecrew-reviewer\`...
   - [@juliusbrussee](https://omgskills.com/library/juliusbrussee/index.md) · 120k stars
- [cavecrew](https://omgskills.com/library/juliusbrussee/caveman/plugins/caveman/skills/cavecrew/index.md) — When to delegate to \`cavecrew-investigator\` (locate code), \`cavecrew-builder\` (1-2 file edit) or \`cavecrew-reviewer\`...
   - [@JuliusBrussee](https://omgskills.com/library/juliusbrussee/index.md) · 116k stars
- [caveman](https://omgskills.com/library/juliusbrussee/caveman/plugins/caveman/skills/caveman/index.md) — Terse caveman voice: answer first, fluff gone, every technical fact kept.
   - [@JuliusBrussee](https://omgskills.com/library/juliusbrussee/index.md) · 116k stars