Type /caveman-stats and get instant token counts and savings for your current session. Unlike most monitoring tools, this reads straight from the Claude Code session log instead of making the AI estimate usage. The hook blocks the command and injects the numbers directly, so the model never even sees the request. Useful when you're curious whether caveman mode is actually saving you tokens or if you're burning through your budget faster than you thought. No guesswork, just the raw numbers from your session.

install copies · 90 days. Times the install command was copied on this site in the last 90 days, bots filtered.
9
skills.sh installs
374.1K
GitHub stars
118.7K
last updated
Aug 21, 2026

Install

$ npx -y skills add juliusbrussee/caveman --skill caveman-stats --agent claude-code

Installs into .claude/skills of the current project.

Files

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 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.

Sponsors

Details

Repository
github.com/juliusbrussee/caveman
First seen
May 16, 2026

More from juliusbrussee/caveman

All 25

Recommended

1juliusbrussee avatarcavemanjuliusbrussee/cavemanUltra-compressed communication mode. Cuts output tokens 65% (measured) by speaking like caveman while keeping full technical accuracy. Supports intensity levels618.3Kskills.sh installs
2mattpocock avatargrill-memattpocock/skillsA relentless interview to sharpen a plan or design.1.5Mskills.sh installs
3shadcn avatarimproveshadcn/improveSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on s40Kskills.sh installs
4obra avatarsystematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes326.7Kskills.sh installs
5forrestchang avatarkarpathy-guidelinesforrestchang/andrej-karpathy-skillsBehavioral guidelines to reduce common LLM coding mistakes through explicit assumptions, simplicity, and verifiable success criteria.17.9Kskills.sh installs
6vercel-labs avatarfind-skillsvercel-labs/skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express int4.3Mskills.sh installs