Open source · MIT License

claumon

See where your Claude Code limits are headed before you hit them - and manage everything Claude Code leaves on your machine. Forecasts from a published, benchmarked statistical model, not a burn-rate guess. Single binary, zero config, one browser tab.

Usage forecasts Rate limit gauges Token costs Memory browser Live updates VS Code extension
Download GitHub
$ brew install fabioconcina/claumon/claumon
$ claumon --open
claumon dashboard screenshot
Live dashboard: rate-limit gauges, token and cost breakdowns, and daily trends over a selectable 7 to 90 day window.
claumon session forecast screenshot
Session forecast: projected usage at reset with an 80% credible interval.

What you get

↗

Usage forecasts

An empirical-Bayes model projects where each limit window lands at reset, with an 80% credible band and ETA to threshold. Refit daily from your own past windows, published as a spec, and benchmarked out-of-sample.

◕

Rate limit gauges

Live 5-hour and 7-day utilization with reset countdowns and color-coded thresholds, plus separate Opus and Sonnet quotas when they apply.

▦

Token breakdown

Input, output, cache read, cache write tokens per session. Estimated API-equivalent costs at current pricing.

◆

Sessions & processes

Browse today's or recent sessions with token counts and costs. See running Claude Code processes live and stop them from the dashboard.

⚙

Memory browser

Search across all CLAUDE.md files, rules, and auto-memories. Filter by type, spot stale entries, get consolidation suggestions for overlapping files.

❖

Memory graph & health scores

Interactive visualization of memory relationships. Per-file health grades (A–F) with improvement suggestions for stale or poorly structured memories.

⚡

Real-time updates

Server-Sent Events push changes instantly. No polling, no manual refresh. Gauges, sessions, and memories update live.

■

VS Code extension

A companion extension shows live usage and the forecast in your editor status bar, with the dashboard embedded in a panel. Get it on the VS Code Marketplace.

Cross-platform

No CGO, no native dependencies. One binary per platform.

macOS

macOS

Apple Silicon & Intel

arm64 amd64
chmod +x claumon-darwin-*. If blocked by Gatekeeper: right-click → Open, or run xattr -d com.apple.quarantine claumon-darwin-*
Linux

Linux

x86_64 & arm64

arm64 amd64
chmod +x claumon-linux-*

Windows

x86_64 & arm64

arm64 amd64
If blocked: right-click the .exe → Properties → Unblock, or run Unblock-File claumon-windows-*.exe

Get started

1

Install

brew install fabioconcina/claumon/claumon on macOS or Linux. Or grab a prebuilt binary.

2

Run once or install as a service

claumon --open for a quick look, or claumon service install to start it on login. Credentials are picked up automatically.

3

Keep it updated

brew update && brew upgrade claumon, or claumon update for binary installs.