diffstat

CLI to compare git refs and show categorized diff stats for code, test, and docs files.

Also available as the diff-stat command (alias).

Install

npm

npm install -g diffstat

Or run without installing:

npx diffstat

Local development

bun install
bun run dev

Bun global link (standalone binary)

bun run install:global

This builds a compiled executable and symlinks diffstat into Bun's global bin directory (usually ~/.bun/bin).

To remove the global link:

bun unlink

Usage

Run inside any git repository:

diffstat
diff-stat              # alias
diffstat --base develop
diffstat --base abc1234 --head def5678
diffstat abc1234..def5678
diffstat --no-color
diffstat --help

Example output:

feature/auth → main

Category  Files  Added  Removed
────────  ─────  ─────  ───────
Total         6   +120      -30
Code          3    +95      -25
Test          2    +20       -5
Docs          1     +5       -0

Options

| Option | Description | |--------|-------------| | -b, --base <ref> | Base ref to compare against (default: main) | | -H, --head <ref> | Head ref to compare (default: current branch HEAD) | | --no-color | Disable colored terminal output | | -h, --help | Show help | | -v, --version | Show version |

Build

Node bundle for npm:

bun run build
node dist/cli.js

Standalone binary:

bun run build:binary
./dist/diffstat

Test

bun test

Publish

npm login
npm pack
npm publish --access public

License

MIT