claudgetclaudget
open source · MIT · macOS / Windows / Linux

Your Claude Code usage, on the desk in real time.

A lightweight, always-on-top desktop widget that reads the transcripts Claude Code already stores — and turns them into a live ledger of tokens, cost, burn rate, plan limits and recent sessions. Zero setup. Fully local.

Download freeView source

Features

Local by default

Tokens, cost, per-model breakdown, session blocks and burn rate — all read from the transcripts Claude Code already stores. 100% offline, no API key.

Optional plan limits

Switch on plan tracking to see your 5-hour and weekly windows, percent remaining and a live reset countdown from Anthropic's usage endpoint. Off by default.

Private by design

Strictly read-only to ~/.claude — it never writes there, never logs your OAuth token, and sends nothing anywhere except api.anthropic.com.

Stays out of the way

Frameless, translucent and always-on-top, with a compact mode, click-through, tray hiding and global hotkeys. Dark, light or system theme, updating in real time.

How it works

The widget combines two independent sources into one snapshot. If the network source is unavailable, it shows the last known values marked Cached and keeps local data flowing.

01

Local transcripts

~/.claude/projects/**/*.jsonl is parsed and aggregated into token counts, cost estimates, a per-model breakdown, ~5-hour blocks, burn rate and an hourly activity series. This is the source of truth for spend — and it works entirely offline.

02

Official usage endpoint

Optionally, api.anthropic.comis read with the OAuth token Claude Code already stored — the source of truth for plan limits (percent used, percent remaining, reset time). Polled no more than every 180s with backoff. Off until you enable it.

Changelog

All releases →
v0.2.2LatestJun 2026
  • New claudget app icon and branding across the app.
v0.2.1Jun 2026
  • Renamed to claudget — installers are now claudget-<version>-…
v0.2.0Jun 2026
  • Glassmorphism redesign — frosted UI, single coral accent.
  • Budgets & alerts: daily/monthly spend limits with native notifications at 80% and 100%.
  • Spend forecast, plan-pace badge, and an insights panel (top project, model split, busiest hour).
  • Stays on top across every macOS Space and over fullscreen apps.
  • Auto-update on Windows & Linux.

Download

Latest release

macOS

Universal .dmg · drag to Applications
11 Big Sur or later · Intel + Apple Silicon
Get for macOS
Unsigned, so macOS blocks first launch. After dragging to Applications, run: xattr -dr com.apple.quarantine /Applications/claudget.app (details below).

Windows

NSIS Setup-x64.exe · or Portable-x64.exe
Windows 10 / 11 · x64
Get for Windows
First open: SmartScreen → "More info" → "Run anyway".

Linux

AppImage-x64 · chmod +x and run
Most modern distros · x64
Get for Linux
No prompt — just chmod +x and run.

Why does my OS warn me? claudget is free and open source, so the builds aren't paid-signed by Apple/Microsoft. The override below is one-time — the code is on GitHub for anyone to read.

macOS (Sequoia blocks unsigned apps and may move them to Trash). Drag claudget to Applications, then in Terminal:

xattr -dr com.apple.quarantine /Applications/claudget.app

Then open it. (Or: System Settings → Privacy & Security → “claudget was blocked” → Open Anyway.) On Windows, SmartScreen → “More info” → “Run anyway”.

Prefer to build it yourself? Clone the repo, run npm install && npm run package and find the installer in packages/desktop/release. Requires Node.js ≥ 20.

Maker

Manan KapoorEngineer · maintainer

I built claudgetbecause I wanted a calmer, always-on way to keep an eye on Claude Code spend without leaving the editor or pasting an API key anywhere. It reads only what the CLI already stores on your machine, stays out of the way, and is free and open source under the MIT license.

Issues, ideas and pull requests are genuinely welcome — the whole thing is built in the open.

@manankapoor23Email