GIT-SUMMARY(1)

📦
version 7.5.0 · 8 versions
, in ubuntu stonking

💖 GIT-SUMMARY(1) 💖

okay bestie, this is git-summary, one of the lil' icons living in the Git Extras collection 🎀 she's the one you call when you wanna know what a repo has been up to — who's been committing, how old it is, how many files are vibing in there. absolute main character energy, no cap 💅

🌸 NAME 🌸

git-summary — show repository summary 🫶

✨ SYNOPSIS ✨

git-summary [--dedup-by-email] [--no-merges] [<committish>]

git-summary --line [<path>]

🦋 DESCRIPTION 🦋

She shows you a summary of the repository 📊 — or, if you're feeling picky, a summary of just a path inside it. lowkey the fastest way to vibe check a codebase before you jump in 🧚

👑 OPTIONS 👑

  • <committish> — only summarize the range of commits that's included in the <committish>. so like, just that slice of history, bestie 🍰
  • <path> — only summarize the range of files that's included in the <path>. narrowing it down, we love to see it 🌈
  • --dedup-by-email — removes duplicate authors who belong to the same email address 🙈 (yes, the same human committing under TJ and Tj — we've all been there). it's giving mysterious-but-solved. for example:
$ git summary
...
133  TJ Holowaychuk            9.9%
115  Tj Holowaychuk            8.5%

$ git summary --dedup-by-email
...
248  TJ Holowaychuk            18.4%
  • --no-merges — exclude merge commits. bye bye merge noise, only the real ones remain 💀
  • --full-path — show the full path of the repository instead of just its directory name. because sometimes you need the whole address, not just the nickname 🏡
  • --line — summarize with lines instead of commits. so when --line is specified, the last argument is treated as <path> 📏
🚨 bestie heads up: this option can not be used together with --dedup-by-email or --no-merges. pick a lane, she said 💅
  • --output-style <style> — summarizes the repo and prints the output in whatever style you picked, diva. the styles:
    • tabular: prints the summary in a tabular form, with a header in the first line and the values in the second 📋 the column separator is a | surrounded by at least one space on each side.
    • oneline: prints the summary in a single line 🪄 fields are separated by a / surrounded by one space on each side.
😭 some information, like the authors, cannot be displayed in this mode. it's a sacrifice, okay.

🔥 EXAMPLES 🔥

outputs a repo summary

$ git summary

project     : express
repo age    : 10 months ago
branch      : master
last active : 3 weeks ago
active on   : 93 days
commits     : 1893
files       : 111
uncommitted : 3
authors     :
 1285 visionmedia
 478 Tj Holowaychuk
  48 Aaron Heckmann
  34 csausdev
  26 ciaranj
   6 Guillermo Rauch
   3 Nick Poulden
   2 Brian McKinney
   2 Benny Wong
   1 Justin Lilly
   1 James Herdman
   1 Adam Sanderson
   1 Viktor Kelemen
   1 Gregory Ritter
   1 Greg Ritter
   1 ewoudj
   1 isaacs
   1 Matt Colyer

and she can take a committish too

this command can also take a committish, and will print a summary for the range of commits included in the committish 🌟

$ git summary v42..

outputs a repo summary by line

$ git summary --line

project  : git-extras
lines    : 26820
authors  :
  ...

filter with the path

$ git summary --line bin/

project  : git-extras
lines    : 4420
authors  :
  ...

tabular summary

$ git summary --output-style tabular
# Repo     | Age       | Last active | Active on | Commits | Uncommitted | Branch
git-extras | 13 years  | 7 hours ago | 807 days  | 1703    | 3           | master

oneline summary

$ git summary --output-style oneline
git-extras / age: 13 years / last active: 7 hours ago / active on 807 days / commits: 1703 / uncommitted: 3 / branch: master

🫶 AUTHOR 🫶

Written by Tj Holowaychuk <tj@vision-media.ca> — an actual legend, periodt 👑

💀 REPORTING BUGS 💀

found something cursed? spill it here: <https://github.com/tj/git-extras/issues>

🌈 SEE ALSO 🌈

<https://github.com/tj/git-extras>

and that's the whole page bestie, you ate 💅💖 much love from the Git Extras girlies, May 2026 edition — now go summarize something and slay ✨🦋🎀

📦 where this page comes from