Install

npm install -g git-receipt

or run instantly with no install:

npx git-receipt

Demo

  ══════════════════════════════════════════
          ★  THANK YOU FOR CODING  ★
              git-receipt v1.0.0
  ══════════════════════════════════════════
  Date:               Mar 21, 2026  11:42 PM
  Repo:                      my-awesome-app
  Branch:                              main
  Period:                        Last 7 days
  ──────────────────────────────────────────
  COMMIT                               LINES
  ──────────────────────────────────────────
  feat: add auth system                 +847
  fix: token expiry edge case            +23
  refactor: split auth middleware       +112
  chore: update dependencies              +4
  fix: null check on user object          +8
  feat: dashboard UI                    +634
  fix: dashboard layout on mobile        -47
  fix: dashboard mobile AGAIN            -12
  feat: export data to CSV              +203
  ──────────────────────────────────────────
  COMMITS                                  9
  LINES ADDED                         +1,831
  LINES REMOVED                         -247
  NET CHANGE                          +1,584
  ··········································
  TAX  (tech debt)                   3 TODOs
  ══════════════════════════════════════════
  CASHIER:                        Jay Smith
  TOP CONTRIB:                    Alice Chen
  GIT:                               2.43.0
  SHELL:                                zsh
  ══════════════════════════════════════════

            THANK YOU, COME AGAIN!
         git commit -m "see you soon"

  ══════════════════════════════════════════
  ★ Keep your .env out of git history
  ★ Small PRs get reviewed, big PRs get merged blindly
  ★ Write the commit message you wish you'd found
  ══════════════════════════════════════════
    | ||| | || ||| || | ||| | || ||| || |
              [email protected]

Usage

# Today's commits (default)
git-receipt

# Last 7 days
git-receipt --week

# Last 30 days
git-receipt --month

# Full repo history
git-receipt --all

# Custom date range
git-receipt --since "Mar 1"
git-receipt --since "2 weeks ago"

# Someone else's receipt
git-receipt --author "Alice"
git-receipt --author "[email protected]"

# Specific branch
git-receipt --branch develop

# Help
git-receipt --help

What's on the receipt

| Section | Description | |---|---| | Date / Repo / Branch | When, where, and what you're printing | | Period | The time range being summarized | | Commit list | Each commit with lines added/removed (up to 22 shown) | | COMMITS | Total commit count in the period | | LINES ADDED | Total insertions across all commits | | LINES REMOVED | Total deletions across all commits | | NET CHANGE | The real size of your contribution | | TAX (tech debt) | Count of TODO, FIXME, HACK comments in the codebase | | CASHIER | Your git config user.name | | TOP CONTRIB | Most prolific committer in the repo (if not you) | | Tips | 3 random coding wisdom tips, different every run | | Barcode | Your git email, encoded as art |

How it works

git log --numstat    →  commits + per-file line stats
       ↓
  aggregate          →  total added, removed, net per commit
       ↓
  git grep           →  count TODO/FIXME/HACK in codebase
       ↓
  render             →  42-char wide thermal receipt format

Requirements

| | | |---|---| | Node.js | >= 18 | | Git | Installed and on your PATH | | Location | Must run from inside a git repository |

FAQ

Thermal receipts are long but not infinite. If you have more than 22 commits in the period, the receipt shows the most recent 22 and prints ... and X more at the bottom. Use --week or --since to narrow the range.

Any occurrence of TODO, FIXME, or HACK in tracked files — scanned with git grep. It reflects the current state of the repo, not the selected period.

Yes — use --author:

git-receipt --week --author "Alice"

Great for sprint reviews or roasting your teammates.

Yes. 3 tips are picked randomly from a pool of 15 each run. Think of it as a fortune cookie at the bottom of your receipt.

Author

Made by Rakesh Bisht

License

MIT