tldr-stats
Show full session token usage, costs, TLDR savings, and hook activity
pinned to #d07ff4bupdated last month
Ask your AI client: “install skills/tldr-stats”.
Requires the metahub MCP server installed in your client. Set up MCP.
mh install skills/tldr-statsmetahub onboarded this repo on the author's behalf.
If you own github.com/parcadei/Continuous-Claude-v3 on GitHub, claim the listing to take over publishing. Your claim preserves the existing eval history and badges; only the curator label is replaced with verified-publisher on your next publish.
Stars
3,883
Last commit
last month
Latest release
published
- #agents
- #claude-code
- #claude-code-cli
- #claude-code-hooks
- #claude-code-mcp
- #claude-code-skills
- #claude-code-subagents
- #claude-skills
- #mcp
About this skill
Pulled from SKILL.md at publish time.
Show a beautiful dashboard with token usage, actual API costs, TLDR savings, and hook activity.
Automated checks the publisher passed at publish time — structure, docs, safety, and whether the artifact behaves as claimed.d07ff4b· last month
Behavioral checks ran but aren't published for this artifact; the static checks above ran at publish time.
Documentation
7 passed2 warningsDescription qualitywarn
11 words · 69 chars — skills use the description as their trigger; aim higher
Aim for 15+ words and include trigger phrases like “use this skill when …”.
Homepage or repository declaredwarn
No homepage or repository declared.
Add a "homepage" or "repository" field to SKILL.md.
README is present and substantial
45,577 chars · 22 sections · 38 code blocks
Tags / topics declared
9 total — agents, claude-code, claude-code-cli, claude-code-hooks, claude-code-mcp, claude-code-skills (+3)
README has usage / example sections
found: Quick Start · Installation · Installation (+1)
Homepage / docs URL declared
no homepage declared (registry will use the repo URL) — info-only, not blocking
Description is substantive
Description is 11 words.
Documentation present and substantive
Documentation present (SKILL.md, 417 words).
Documentation shows usage
Documentation includes 2 code examples.
Release history
1- releasecurrentd07ff4bwarnlast month
Contents
Show a beautiful dashboard with token usage, actual API costs, TLDR savings, and hook activity.
When to Use
- See how much TLDR is saving you in real $ terms
- Check total session token usage and costs
- Before/after comparisons of TLDR effectiveness
- Debug whether TLDR/hooks are being used
- See which model is being used
Instructions
IMPORTANT: Run the script AND display the output to the user.
- Run the stats script:
python3 $CLAUDE_PROJECT_DIR/.claude/scripts/tldr_stats.py
- Copy the full output into your response so the user sees the dashboard directly in the chat. Do not just run the command silently - the user wants to see the stats.
Sample Output
╔══════════════════════════════════════════════════════════════╗
║ 📊 Session Stats ║
╚══════════════════════════════════════════════════════════════╝
You've spent $96.52 this session
Tokens Used
1.2M sent to Claude
416.3K received back
97.8K from prompt cache (8% reused)
TLDR Savings
You sent: 1.2M
Without TLDR: 2.5M
💰 TLDR saved you ~$18.83
(Without TLDR: $115.35 → With TLDR: $96.52)
File reads: 1.3M → 20.9K █████████░ 98% smaller
TLDR Cache
Re-reading the same file? TLDR remembers it.
█████░░░░░░░░░░ 37% cache hits
(35 reused / 60 parsed fresh)
Hooks: 553 calls (✓ all ok)
History: █▃▄ ▇▃▇▆ avg 84% compression
Daemon: 24m up │ 3 sessions
Understanding the Numbers
| Metric | What it means |
|---|---|
| You've spent | Actual $ spent on Claude API this session |
| You sent / Without TLDR | Actual tokens vs what it would have been |
| TLDR saved you | Money saved by compressing file reads |
| File reads X → Y | Raw file tokens compressed to TLDR summary |
| Cache hits | How often TLDR reuses parsed file results |
| History sparkline | Compression % over recent sessions (█ = high) |
Visual Elements
- Progress bars show savings and cache efficiency at a glance
- Sparklines show historical trends (█ = high savings, ▁ = low)
- Colors indicate status (green = good, yellow = moderate, red = concern)
- Emojis distinguish model types (🎭 Opus, 🎵 Sonnet, 🍃 Haiku)
Notes
- Token savings vary by file size (big files = more savings)
- Cache hit rate starts low, increases as you re-read files
- Cost estimates use: Opus $15/1M, Sonnet $3/1M, Haiku $0.25/1M
- Stats update in real-time as you work
Reviews
No reviews yet. Be the first.
Related
Verification Before Completion
Evidence before assertions, always
Writing Plans
Turn specs into phased implementation plans
Test-Driven Development
Red → green → refactor discipline for any feature or bugfix
mh install skills/tldr-stats