blame-me 😬

A fun CLI tool that analyzes your Git repository and tells you who is responsible for the mess.

Features

| Feature | What it does | |---|---| | 📊 Commit overview | Total commits + per-author breakdown with progress bars | | 👥 Top 3 contributors | Ranked leaderboard with medals 🥇🥈🥉 | | 💬 Message quality | Detects lazy commit messages (fix, temp, final, etc.) | | 🔥 --roast flag | Personalised humorous commentary on your contribution | | --dir <path> | Point at any repo, not just cwd |

Build & Install

1. Install dependencies

npm install

2. Compile TypeScript → JavaScript

npm run build

This runs tsc and emits compiled files to dist/.

3. Test locally with npm link

npm link

This creates a global symlink so you can run blame-me from any directory:

blame-me                     # analyse the current repo
blame-me --roast             # adds a humorous personal roast
blame-me --dir ~/my-project  # analyse a different repo
blame-me --version           # print version
blame-me --help              # usage info

4. Unlink when done

npm unlink -g blame-me

Project Structure

blame-me/
├── src/
│   ├── index.ts      # CLI entry point (commander wiring + display)
│   ├── git.ts        # Git command helpers (spawnSync wrappers)
│   ├── analyzer.ts   # Pure data analysis (no I/O, no side-effects)
│   └── utils.ts      # Display helpers (progress bar, roast generator)
├── dist/             # Compiled JS output (after npm run build)
├── package.json
└── tsconfig.json

Design decisions

• Synchronous (spawnSync) git execution — this is a one-shot interactive CLI, so blocking is fine and makes the code much simpler than async chains.
• chalk v4 — used because chalk v5 is ESM-only, incompatible with "module": "commonjs" in tsconfig.
• Zero business logic in index.ts — all data crunching lives in analyzer.ts (pure functions), display utilities in utils.ts. Easy to test independently.

Example Output

  🔍  blame-me  ·  Git Responsibility Analyzer
  ────────────────────────────────────────────

  📊  Commit Overview
  ············································
  Total commits : 238

  😬  You wrote 52% of this repo
        ███████████░░░░░░░░░ 124 commits

  👥  Top Contributors
  ············································
  🥇  Yash (you)                           52%  124 commits
       ███████████░░░░░░░░░
  🥈  Alice                                31%   74 commits
       ███████░░░░░░░░░░░░░
  🥉  Bob                                  17%   40 commits
       ███░░░░░░░░░░░░░░░░░

  💬  Commit Message Quality
  ············································
  💀  Worst commit message : "final final fix"
  🚩  Lazy commits found   : 17 / 238 total

  ────────────────────────────────────────────

  🔥  ROAST MODE
  Archaeology called — they found your 'final final fix' commit and they're confused too 🦕

  ────────────────────────────────────────────
  blame-me v1.0.0  ·  no blame, just data 😇