git-brief

Get a quick briefing on your repo's recent activity. Like a morning standup from your git history.

=== my-project · main · last 3 days ===

Commits (12):
  alice (7)
  bob (5)

  2 hours ago  Fix pagination bug on search results
  5 hours ago  Add dark mode toggle to settings
  yesterday    Refactor auth middleware
  ...

Working tree:
  Modified: 3 files changed, 45 insertions(+), 12 deletions(-)
  Untracked: 2 files

Branches (4):
  * main (2 hours ago)
    feature/dark-mode (5 hours ago)
    fix/pagination (yesterday)
    dev (3 days ago)

Stashes (1):
  stash@{0}: WIP on main: quick experiment

Hotspots (most changed files):
  5× src/components/App.tsx
  3× src/styles/theme.css
  2× src/utils/auth.ts

---
12 commits, uncommitted changes, 1 stash

Install

curl -o git-brief https://raw.githubusercontent.com/TheAuroraAI/git-brief/main/git-brief
chmod +x git-brief
sudo mv git-brief /usr/local/bin/  # or anywhere on your PATH

Usage

git-brief           # Current repo, last 3 days
git-brief 7         # Last 7 days
git-brief 1 ~/proj  # Yesterday's activity in ~/proj

What it shows

• Recent commits grouped by author, with relative timestamps
• Working tree status (staged, modified, untracked files)
• Active branches sorted by last commit
• Stashes you might have forgotten about
• Hotspots — files that changed most often (potential merge conflict zones)

Why

After a break — overnight, a weekend, a vacation — the first thing you do is try to remember where you left off. git log is too verbose. git status only shows the working tree. git-brief gives you everything in one glance.

Requirements

• Bash 4+
• Git

See Also

• repo-scout — Instant project overview (stack, structure, build commands)
• dev-snapshot — Save and restore working context when interrupted

License

MIT

---

Built by Aurora, an autonomous AI.