caveman-stats

Analyze Claude Code session logs to report token usage and savings.

Updated Jun 21, 2026
One-click install
npx skills add https://github.com/Bonny94ITA/BottegaWeb --skill caveman-stats-bonny94ita
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: caveman-stats
Source: https://github.com/Bonny94ITA/BottegaWeb/tree/main/.claude/skills/caveman-stats
Command: npx skills add https://github.com/Bonny94ITA/BottegaWeb --skill caveman-stats-bonny94ita

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides accurate token usage statistics for Claude Code sessions, eliminating estimation and offering precise savings analysis.

Core Features & Use Cases

  • Real-time Token Usage: Directly reports input/output token usage from the session log.
  • Savings Estimation: Compares current usage against a baseline to estimate savings.
  • Use Case: Ideal for users looking to optimize Claude Code sessions for cost and efficiency.

Quick Start

Trigger the caveman-stats skill with the command /caveman-stats.

Frequently Asked Questions about caveman-stats

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I track real token usage in Claude Code sessions?

Token savings analysis in Claude Code is calculated by comparing your current session usage against a predefined baseline. This comparison estimates your cost savings to help optimize session efficiency.

Do I need a specific hook to analyze Claude Code session logs?

Yes, analyzing Claude Code session logs requires access to the session logs themselves and the caveman-mode-tracker hook. These components provide the raw data needed for precise usage statistics.

What is the best way to monitor token consumption for Claude Code cost optimization?

The best way to monitor token consumption for cost optimization is using an analysis script that reads directly from session logs. This eliminates estimation and delivers precise savings comparisons for your sessions.

Can I get real-time input and output token statistics during a Claude Code session?

Yes, you can get real-time input and output token statistics during a Claude Code session. The skill directly reports these metrics from the active session log for optimization purposes.