Claude Code usage

claudetop

htop for Claude Code sessions showing real-time cost, cache efficiency and alerts.

212 stars 10 forksUsage & cost trackers Plugin marketplace Source

Install

Install
claude plugin marketplace add liorwn/claudetop
From source
git clone https://github.com/liorwn/claudetop.git

From the README

claudetop
  You're spending $20/day on Claude Code and can't see it.
  claudetop shows you exactly where your tokens and dollars go — in real time.

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)

One-liner

As a Claude Code plugin

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

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 much plan you have left — 5-hour, 7-day, and per-model (Fable/Opus/Sonnet) windows with reset countdowns
- 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

Plan usage windows (subscribers)
If you're on a Claude Pro/Max/Team plan, the plan: line shows every rate-limit window Anthropic enforces on you — as a bar, % used, and time until it resets:

Bars go yellow at 50% and red at 80%. At 90% you get a Fable LIMIT 93% ↻4d1h alert so you can switch models or wrap up before Claude Code stops you. The minimal…
Read the full README on GitHub

Details

Language
Shell
License
MIT
Last updated
7 September 2026
Topics
ai-toolsanthropicclaudeclaude-codeclicost-trackingdeveloper-toolsdevtoolsstatus-lineterminaltokens

FAQ

What is claudetop?

htop for Claude Code sessions showing real-time cost, cache efficiency and alerts. It is a usage for Claude Code, from liorwn/claudetop on GitHub.

How do I install claudetop?

Run claude plugin marketplace add liorwn/claudetop, then follow the setup in the README.

Is claudetop popular?

liorwn/claudetop has 212 GitHub stars and 10 forks. It was last updated on 7 September 2026.

More usage & cost trackers

Browse the most popular Claude Code mods, all usage & cost trackers, or the skills and MCP server directories.