daily-robots/.agents/skills/caveman-stats/README.md

caveman-stats

Real session token receipts. No AI estimation.

What it does

Reads the current Claude Code session log directly and reports actual input/output token usage plus estimated savings versus a non-caveman baseline. Numbers come from the JSONL session log on disk — the model itself does not compute or estimate them. Output is injected by the caveman-mode-tracker hook, which intercepts /caveman-stats and returns the formatted stats as a blocked-decision reason.

Each run also writes a lifetime-savings suffix file used by the statusline badge (⛏ 12.4k).

How to invoke

/caveman-stats

Example output

Session: 47 turns
Input:   12,304 tokens
Output:   3,891 tokens (caveman)
Baseline: 11,247 tokens (estimated without caveman)
Saved:    7,356 tokens (~65%)

See also

• SKILL.md — hook contract and mechanics
• Caveman README — repo overview