caveman-stats

Read internal session logs to report real-time token usage and costs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the lack of visibility into AI token consumption, allowing users to track their actual usage and estimated savings during a session without relying on AI-generated guesses.

Core Features & Use Cases

  • Real-time Usage Tracking: Displays accurate token counts directly from the session logs.
  • Cost Transparency: Provides immediate feedback on session efficiency and resource consumption.
  • Use Case: Use this during a long coding session to verify how many tokens your current workflow is consuming and to ensure you are staying within your budget or usage limits.

Quick Start

Type /caveman-stats in the chat to display your current session token usage and estimated savings.

Frequently Asked Questions about caveman-stats

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

FAQPage Schema
How do I monitor real-time token usage and session costs during AI-assisted development?

Real-time token usage is monitored by reading directly from internal session logs via a hook-based trigger. This mechanism ensures accurate, non-AI-estimated reporting of your active session metrics and costs.

How do I track actual token consumption without relying on AI-generated guesses?

Actual token consumption is tracked by accessing internal session logs instead of AI-generated guesses. A hook-based trigger mechanism provides accurate, real-time visibility into your resource consumption and estimated savings.

How do I check current session token counts and estimated savings in a coding workflow?

Current session token counts and estimated savings are checked by triggering a command in the chat. This reads your session logs to display accurate token usage and cost transparency for your workflow.

Can I use session log monitoring to manage AI development budget and usage limits?

Session log monitoring can be used to manage your AI development budget. It provides immediate feedback on session efficiency, helping you verify token consumption and stay within your usage limits.

Why does real-time token usage reporting use a hook-based trigger mechanism?

Real-time token usage reporting uses a hook-based trigger mechanism to ensure accurate, non-AI-estimated reporting. This approach directly reads internal session logs to capture exact metrics without relying on approximations.