TokenPulse

Know exactly where your tokens go.

Track your Claude Code Max burn rate. Per-project breakdowns, usage projections, terminal charts.

Get TokenPulse — $5
tokenpulse
$ |

See it in action

All your commands. Everything you need.

tokenpulse
$ |

Real-time usage status with burn rate and projections

Everything you need to stay in control

Built for developers who care about their token budget.

Burn Rate Projections
Weighted calculations project your usage to the end of the billing cycle.
Per-Project Breakdown
See exactly which projects are eating your tokens, sorted by cost.
Beautiful Charts
Terminal ASCII charts + exportable PNGs with a dark theme palette.
Background Daemon
Auto-scans every 15 minutes via launchd. Set it and forget it.
Share Your Stats
Generate a styled stats card and share on socials or with your team.
Privacy Mode
Toggle to redact project names before sharing. Keep your work private.
Smart Calibration
Log actual usage % to map tokens to real usage. Recalibrate anytime.
Configurable Cycles
Set your timezone, reset day, and token weights to match your plan.
Cycle History
Browse past billing cycles. See snapshots, max usage, and week-over-week trends.
Manual Logging
Log your actual usage % to calibrate token-to-usage mapping for better accuracy.
PNG Export
Export any chart as a publication-ready PNG. Dark theme, crisp at any size.
Recalibrate
Re-run calibration when your token-to-usage mapping drifts. Stay accurate.

Built for the terminal

Everything you need, nothing you don't.

Live Burn Rate

See your tokens/hour and projected end-of-cycle usage at a glance.

Burn rate: 0.54%/hr
Projected: 62.5% at reset
Safe budget: 0.89%/hr remaining

Terminal-Native

No browser, no GUI. Everything runs in your terminal where you already work.

ASCII Charts

Beautiful timeline and project charts rendered right in your shell.

Privacy First

Toggle privacy mode to redact project names. Share stats without exposing your work.

Auto-Scan Daemon

Background service scans every 15 min via launchd. Always up to date.

Shareable Cards

Export styled stats cards as PNGs. Share on socials or with your team.

Cycle History

Browse past billing cycles and track how your usage patterns evolve.

Export PNGs

Export charts as publication-ready PNGs with the dark theme palette.

Manual Logging

Log your actual usage % from the Anthropic dashboard. Improve accuracy over time.

Recalibrate

Recalibrate the token-to-usage mapping when your calibration drifts.

Share your stats

Export a styled card with one command. Privacy mode keeps project names hidden.

TokenPulse StatsFeb 14 – Feb 21
Current usage42.3%
Burn rate0.542%/hr
Projected at reset62.5%
Safe budget0.891%/hr
Top projects--private
████████ ██████28.4%
████████ ████22.1%
████████ ███14.7%
tokenpulse
$ usage share --private
Generating stats card...
Privacy mode: ON (project names redacted)
Theme: dark
Size: 1200×630
Stats card saved to ~/Desktop/tokenpulse-stats.png
✓ Copied to clipboard!

Copy to clipboard

Paste directly into Slack, Discord, or anywhere.

Redact project names

Privacy mode hides sensitive project details.

Share on socials

Publication-ready PNG at 1200×630 for social cards.

Up and running in 60 seconds

Three commands. That's it.

1

Install

$ pip install tokenpulse

One command. No dependencies beyond Python 3.10+.

2

Configure

$ usage config --init

Set your timezone, billing cycle reset day, and token weights.

3

Monitor

$ usage daemon start

Auto-scans every 15 minutes. Check anytime with `usage`.

Simple pricing

Popular with Claude Code Max subscribers

One-time purchase
$5
  • Full source code included
  • All future updates free
  • Runs 100% locally on your machine
  • No telemetry, no cloud, no accounts
Get TokenPulse

macOS · Python 3.10+ · No cloud · No telemetry