claudetop

<p align="center"> <h1 align="center">claudetop</h1> <p align="center"><strong>You're spending $20/day on Claude Code and can't see it.</strong></p> <p align="center">claudetop shows you exactly where your tokens and dollars go — in real time.</p> <p align="center"> <a href="#install"><img src="https://img.shields.io/badge/install-1_command-blue" alt="Install"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="MIT License"></a> <a href="#plugins"><img src="https://img.shields.io/badge/plugins-8_included-orange" alt="Plugins"></a> </p> </p>

---

<p align="center"> <img src="demo.png" alt="claudetop in action — healthy session (top) vs problem session (bottom)" width="800"> </p>

14:32  my-project/src/app  Opus  20m 0s  +256/-43  #auth-refactor
152.3K in / 45.2K out  ████░░░░░░ 38%  $3.47  $5.10/hr  ~$174/mo
cache: 66%  efficiency: $0.012/line  opus:~$3.20  sonnet:~$0.88  haiku:~$0.23
in:80% out:20% (fresh:15% cwrite:7% cread:76%)
$5 MARK  |  main*  |  ♫ Artist - Song  |  PROJ-123  |  CI ✓

The problem

Claude Code doesn't show you what you're spending. You finish a session, check your billing dashboard, and discover a $65 charge for what felt like 30 minutes of work. You have no idea which session caused it, which model was wasteful, or whether your cache was even working.

I built claudetop after noticing my model estimate showed $10 but the actual bill was $65. Turns out, compaction was hiding 80% of my token usage. The cost was real — the visibility wasn't.

Install

Clone and install (recommended)

git clone https://github.com/liorwn/claudetop.git
cd claudetop && ./install.sh

One-liner

curl -fsSL https://raw.githubusercontent.com/liorwn/claudetop/main/install.sh | bash

As a Claude Code plugin

claude plugin marketplace add liorwn/claudetop
claude plugin install claudetop

This gives you the SessionEnd hook + all slash commands (/claudetop:stats, /claudetop:dashboard, /claudetop:branch, /claudetop:export, /claudetop:pricing) automatically.

Then restart Claude Code.

What you see

Before claudetop

>

A blank prompt. No context. No cost. No idea.

After claudetop

14:32  my-project/src/app  Opus  20m 0s  +256/-43  #auth-refactor
152.3K in / 45.2K out  ████░░░░░░ 38%  $3.47  $5.10/hr  ~$174/mo
cache: 66%  efficiency: $0.012/line  opus:~$3.20  sonnet:~$0.88  haiku:~$0.23
$5 MARK  |  TRY /fast  |  main*  |  CI ✓  |  ♫ Bonobo - Kerala

Every response, you see:

• What project you're in and how deep
• What model is running and for how long
• What it costs right now, per hour, and projected monthly
• How efficient your cache is (are you wasting tokens?)
• What it would cost on a different model (should you switch?)
• Smart alerts when something is wrong

Features

Real-time cost tracking

Your actual session cost (green), burn rate per hour, and monthly forecast ext...