9b5c1b5719
- Implemented `caveman-compress` skill to detect and compress natural language files. - Created `caveman-review` skill for generating concise code review comments. - Added `caveman-help` skill providing a quick-reference card for commands and modes. - Developed `caveman-stats` skill to report real token usage and savings from the session log. - Updated README and SKILL.md files for all new skills with usage instructions and examples. - Introduced a script to clear banners from the database. - Updated skills-lock.json to include new skills and their metadata. |
||
|---|---|---|
| .. | ||
| README.md | ||
| SKILL.md | ||
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