claudeers.
// Claude Plugins

vibe-receipts

🧾 Receipts for your vibe coding β€” how many hours did you really work with Claude? Measured from your own prompts, with commits as proof.

// Claude Plugins[ cli ][ api ][ desktop ][ web ][ mobile ][ claude ]#claude#claude-code#claude-code-plugin#developer-tools#productivity#time-tracking#vibe-coding#pluginsβ—· MIT$open-sourceupdated about 1 month ago
Actively maintained
98/100
last commit 10 days ago
last release none
releases 0
open issues 0
// star history

Install with your AI

Paste into Claude Code, Cursor, or any agent β€” it reads the repo and wires the tool into your project.

Install and set up vibe-receipts (claude-plugin project) into my current project.
Found on https://claudeers.com/vibe-receipts
Repo: https://github.com/sahmett/vibe-receipts
Homepage/docs: β€”
Detected install method: claude-plugin β†’ /plugin install vibe-receipts@sahmett/vibe-receipts
Category: plugins. Platforms: cli, api, desktop, web, mobile.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)
/plugin marketplace add sahmett/vibe-receipts
/plugin install vibe-receipts@sahmett/vibe-receipts
// or clone
git clone https://github.com/sahmett/vibe-receipts

// compatibility

Platformscli, api, desktop, web, mobile
Operating systemsβ€”
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data β†—

🧾 vibe-receipts

How long did that "2-hour project" actually take? vibe-receipts turns your Claude Code history into a shareable work-time receipt: the hours you really spent, measured from your own prompts, and what those tokens would cost on the API.

A vibe-receipts receipt: 11h 05m total, $138.14 token value

Demo from 100% synthetic data (demo/make_demo.py) Β· full report

Your prompts are the clock. Your commits are the proof of what you built.

One Python file, zero dependencies, everything runs on your machine. Point it at any folder you used Claude Code in (a git repo or not) and get:

  • a receipt card (PNG) to share: working time, prompts, agents, tokens, model mix, commits and the token value
  • a full HTML report with your prompt rhythm, the break threshold and why, a sensitivity table and a daily commit log
  • a daily CSV for timesheets and invoices

Who is this for?

  • Freelancers and consultants who build with Claude Code and bill by the hour: a daily CSV and a per-day commit log for the timesheet, measured instead of guessed.
  • Vibe coders who want to know what that weekend project really took, in hours and in tokens.
  • Anyone who wants to show their work: one image and a caption, ready to post.

It measures your own work from your own Claude Code logs, on your machine. It can't see what other people did, or work you did outside Claude Code.

Install

Works in Claude Code: the CLI, the desktop app's Code tab and the IDE extensions. It doesn't work in a claude.ai chat, because it reads the Claude Code logs on your machine.

As a skill (copy one folder)

git clone --depth 1 https://github.com/sahmett/vibe-receipts /tmp/vibe-receipts
mkdir -p ~/.claude/skills && cp -r /tmp/vibe-receipts/skills/vibe-receipts ~/.claude/skills/

Open a new Claude Code session and it's there. To use it in one project only, copy the folder to that project's .claude/skills/ instead.

Or as a plugin (easy updates)

/plugin marketplace add sahmett/vibe-receipts
/plugin install vibe-receipts@vibe-receipts

Then just ask Claude:

  • "How many hours did I work on this repo this week?"
  • "Give me the receipts for June."
  • "Make a timesheet of my commits for the client invoice."

The skill turns your question into the right date range and author filter, runs the script, and tells you the headline number, your rhythm, the busiest days, and what got done each day.

[!IMPORTANT] Claude Code deletes session logs after 30 days by default, and with them your receipts. To keep them, add "cleanupPeriodDays": 36500 to ~/.claude/settings.json.

Or run it directly

git clone https://github.com/sahmett/vibe-receipts
python3 vibe-receipts/receipts.py ~/code/my-project

Outputs go to ~/vibe-receipts/ (<repo>-receipt.png, <repo>-report.html, <repo>-daily.csv), never into the analysed repo. The PNG is rendered with your local Chrome/Chromium in headless mode (CHROME=/path/to/browser to pick one, --no-png to skip it). --built "mobile app" says what you built on the receipt (the skill fills it in from your README), and --name shows another project name, handy for client work.

Requirements

  • Python 3.9 or newer, standard library only
  • Claude Code session logs in ~/.claude/projects (the CLI and the desktop app both write them)
  • Optional: git for commits and lines of code, and Chrome, Chromium, Edge or Brave for the receipt PNG

Share your receipt

Every run prints a Share: line, a ready-made caption for the PNG:

β€œIt's a 2-hour project.” 11h 5m later, $138.14 of tokens. 🧾 github.com/sahmett/vibe-receipts #vibereceipts

Post it with #vibereceipts. We'd love to see yours.

How it works

Working time = gaps between your prompts

Claude Code logs every session in ~/.claude/projects/<project>/*.jsonl. vibe-receipts keeps only the records you put in:

  • messages you typed
  • your answers to Claude's AskUserQuestion questions (those are your decisions)

Claude's replies, tool calls and results, subagent traffic, compaction summaries, IDE/system injections, background-task notifications and "interrupted" markers are not prompts.

A gap between two consecutive prompts that is within your break threshold counts as work, because waiting for Claude, reviewing its output and deciding what to ask next is the work. A longer gap is a break and is dropped.

10:00  you: "add auth"
10:03  you: "use magic links"    β†’ +3 min
10:09  you: answer to a question β†’ +6 min
10:51  you: "now the tests"      β†’ 42 min gap > threshold β†’ break, not counted
10:54  you: "fix the flaky one"  β†’ +3 min
                                   = 12 min

Your break threshold is learned from your rhythm

There is no fixed idle timeout. vibe-receipts looks at all the gaps between your prompts and applies Tukey's outlier rule, the rule box plots use:

threshold = Q3 + 1.5 Γ— IQR      (Q1, Q3 = 25th / 75th percentile of your gaps, IQR = Q3 βˆ’ Q1)

A gap that is unusually long for you is a break. A project where Claude runs long tasks between your prompts gets a higher threshold, but never above 30 min: past half an hour we count it as a break for anyone. With fewer than 20 gaps there is not enough data, so it uses 15 min. The report and the receipt say which case applied, and the report shows Q1 / median / Q3 / P90 and a sensitivity table (5 β†’ 60 min). Want a fixed one? --break 20, or ask Claude to "recalculate with 20 minutes".

Commits add context

Commits don't decide the hours. They show what got built: commit count, effective lines of code (weighted: code Γ—1.0 Β· config Γ—0.4 Β· docs / vendored / generated Γ—0; CODE LINES on the receipt), lines per hour, minutes per commit and a daily commit log.

No git? Still works. If the folder is not a git repo, has no commits in the range, or git is not installed, the hours and token value are measured as usual. The receipt simply leaves commits out and the report says why. vibe-receipts never talks to GitHub; it only reads local git history.

Token value β‰  what you paid

TOKEN VALUE estimates what the recorded usage would cost at Anthropic API list prices (PRICES in receipts.py). It is not your Claude subscription cost. It covers:

  • input and output, per model
  • cache reads, and cache writes at 1.25Γ— input (5-minute cache) or 2Γ— (1-hour cache)
  • fast mode at 2Γ—
  • subagents

The report breaks it down and shows what it would have cost without the prompt cache. Responses from models missing from PRICES are left out and the value is shown as β‰₯.

The full report

Every receipt comes with a full HTML report: the headline numbers, how your gaps between prompts spread out, how much the total moves if the break threshold changes, what the tokens are worth and which models wrote them, a daily table and a daily commit log.

Highlights of the vibe-receipts HTML report: working time, gap rhythm, threshold sensitivity, token value, model mix, daily table and a day of the commit log

Highlights from the synthetic demo report Β· see the whole report

Privacy

Everything runs locally. vibe-receipts reads your Claude Code transcripts and git history on your machine and writes its outputs to ~/vibe-receipts/. It never uploads your prompts, code, logs or reports. The only network request is the receipt card loading its font from Google Fonts while it is rendered.

Options

FlagMeaning
repofolder to analyse, git repo or not (default .)
--since / --untilday range YYYY-MM-DD, applied to both prompts and commits (default: the days your prompts cover, so older commits are left out)
--authoronly this author's commits (git log --author pattern)
--break MINfixed break threshold in minutes (default: learned from your rhythm); --idle is the old name
--builtwhat the project is, 1–3 words, shown on the receipt
--nameproject name shown in the report and on the receipt
--lang en|trreport language (default: from $LANG, else English)
--transcripts DIRClaude log folder, overrides auto-detection (repeatable, e.g. for a repo cloned in two places)
--out DIRoutput folder (default ~/vibe-receipts)
--no-pngskip the receipt PNG

Constants at the top of receipts.py: IDLE (fallback threshold), CAP, MIN_GAPS, SENS (thresholds in the sensitivity table), PRICES, CODE_W, VENDOR_RE / GEN_RE (excluded file patterns), and SESSION_GAP / SESSION_MIN / SESSION_SPAN for the commit estimate.

No session logs? Estimated from commits

For a repo with no Claude logs, the hours are estimated from commit sessions: one author's commits less than 60 min apart form a session, and each session counts about 48 min plus 5% of its length. These numbers were fitted on 112 days of Claude-assisted solo work in 7 repos, where prompt-measured hours were known; for a repo left out of the fit the estimate was off by 15% on average. The receipt says it is an estimate. Work without any commits stays invisible to it.

Full report as an image

The receipt PNG is made for you. To turn the full HTML report into a long JPEG too:

bash to_jpg.sh ~/vibe-receipts/<repo>-report.html   # macOS + Google Chrome + Pillow

FAQ

Is the token value what I paid?

No. It is what the same usage would cost at Anthropic API list prices. A Claude subscription costs something else. See Token value β‰  what you paid.

It found no prompts, or the hours look too low.
  • Claude Code deletes session logs after 30 days by default. Older work is gone unless you set "cleanupPeriodDays" (see Install).
  • Logs are stored by folder path. If you moved or renamed the project, point at the old logs with --transcripts ~/.claude/projects/<old-path-with-dashes>.
  • If you walk away while Claude works, that gap counts as a break once it passes your break threshold (30 min at most). --break 45 counts longer gaps as work.
No PNG was made.

The card is rendered with a local Chrome, Chromium, Edge or Brave. If none is found, the run says so and writes the card as HTML next to the report. Set CHROME=/path/to/browser to pick one.

Do I need git or GitHub?

No. The hours come from your prompts. Git only adds commits and lines of code, and vibe-receipts never talks to GitHub.

Older commits are missing from the receipt.

By default the date range is the days your prompts cover, so the period, commits and lines describe the same work as the hours. Use --since / --until to choose the range yourself.

Can I use it on a repo without Claude Code logs?

Yes, but then the hours are an estimate from commit sessions, not a measurement. See No session logs?.

Repo layout

.claude-plugin/            plugin + marketplace manifests
skills/vibe-receipts/
β”œβ”€β”€ SKILL.md               when and how Claude runs it
└── scripts/
    β”œβ”€β”€ receipts.py        analysis, HTML report, receipt card
    └── to_jpg.sh          report β†’ JPEG
receipts.py, to_jpg.sh     shortcuts (symlinks)
demo/make_demo.py          rebuilds the synthetic demo above

License

MIT, see LICENSE.

// faq

What is vibe-receipts?

🧾 Receipts for your vibe coding β€” how many hours did you really work with Claude? Measured from your own prompts, with commits as proof.. It is open-source on GitHub.

Is vibe-receipts free to use?

vibe-receipts is open-source under the MIT license, so it is free to use.

What category does vibe-receipts belong to?

vibe-receipts is listed under plugins in the Claudeers registry of Claude-compatible tools.

13 views
β˜… 16 stars
unclaimed
updated about 1 month ago

// embed badge

vibe-receipts on Claudeers
[![Claudeers](https://claudeers.com/api/badge/vibe-receipts.svg)](https://claudeers.com/vibe-receipts)

// retro hit counter

vibe-receipts hit counter
[![Hits](https://claudeers.com/api/counter/vibe-receipts.svg)](https://claudeers.com/vibe-receipts)

// reviews

// guestbook

0/500

// related in Claude Plugins

πŸ”“

A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.

// pluginsmultica-ai/β˜… 230,631[ claude ]
πŸ”“

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explainin…

// pluginsanthropics/⟨PythonβŸ©β˜… 156,472[ claude ]
πŸ”“

"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/

// pluginsHKUDS/⟨PythonβŸ©β˜… 58,467β—· Apache-2.0[ claude ]
πŸ”“

financial-services β€” a Claude ecosystem project on GitHub.

// pluginsanthropics/⟨PythonβŸ©β˜… 41,409β—· Apache-2.0[ claude ]
β†’ see how vibe-receipts connects across the ecosystem