Skip to content

Receipt 0.2.0 — usage awareness

Choose a tag to compare

@noah-thing noah-thing released this 30 Jun 10:49

See what a task costs you, not just dollars. 🔋

Receipt now measures every task as a share of your Claude plan's windows — the 5-hour and weekly limits — and turns that into things that change how you work.

New commands

  • receipt fuel — how much of your plan you're using right now, what's left, and your pace
  • receipt records — your heaviest, leanest, and most recent tasks, ranked
  • receipt forecast — a typical task's window impact and your weekly runway
  • receipt statusline — a one-line gauge for the Claude Code statusline
  • receipt calibrate — set your real budget from a limit you actually hit
  • receipt budget plan <pro|max5x|max20x> — pick your tier

On the PR comment and receipt show: a usage block with the % of your 5h and weekly windows the branch ate, the same number in your own work-units, an efficiency grade, and the one lever worth pulling (what the heavy model's reads would cost on a cheaper one). Add --fun for honest playful comparisons.

Real numbers, honestly. The proxy now reads your true ceiling from the provider's anthropic-ratelimit-* headers; or receipt calibrate learns it from a wall you hit. Presets are clearly labeled estimates. How it all works: docs/LIMITS.md.

Everything reads the same local, append-only ledger — no prompts, nothing leaves your machine. 60 tests, typecheck clean. MIT.