Install

npm install -g morning-git

or run instantly without installing:

npx morning-git

Demo

  morning-git

  ┌───────────────────────────────────────────────┐
  │  🗓  Thursday, Mar 20, 2026                    │
  │  Standup ready                                 │
  └───────────────────────────────────────────────┘

  my-awesome-app  (main)
  ────────────────────────────────────────────────
  ✦  a1b2c3d  feat: add JWT refresh token logic  +84 −12  11:42 PM
  ✦  e4f5a6b  fix: handle null user on login      +6 −2   10:15 PM
  ✦  c7d8e9f  fix: token expiry edge case         +3 −1    9:03 PM

  secret-history  (main)
  ────────────────────────────────────────────────
  ✦  1a2b3c4  fix: porcelain parser commit cache bug  +18 −5  08:44 PM
  ✦  5d6e7f8  feat: contributor leaderboard           +47     07:21 PM

  blame-yourself  (main)
  ────────────────────────────────────────────────
  ✦  9a0b1c2  chore: update README and LICENSE  +12 −8  06:10 PM

  ────────────────────────────────────────────────
  3 repos  ·  6 commits  ·  Thursday, Mar 20, 2026

Usage

# Last working day in current repo (default)
morning-git

# All repos inside a workspace folder
morning-git ~/Sites
morning-git ~/projects

# Look back N working days
morning-git --days 3

# After a long weekend
morning-git --days 4

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

# Everyone's commits
morning-git --all

# Copy output to clipboard (paste into Slack/Teams)
morning-git --copy

# Combine flags
morning-git ~/Sites --days 2 --copy

Options

| Option | Description | |---|---| | [workspace] | Path to a folder — scans all git repos inside (up to 3 levels deep) | | --days <n> | Look back N working days (skips weekends). Default: 1 | | --author <name> | Filter by author name or email | | --all | Show commits from all authors, not just you | | --copy | Copy the output to clipboard — ready to paste into Slack, Teams, Jira | | -h, --help | Show help |

How it works

determine time window   →  last N working days (weekends skipped)
        ↓
find repos              →  current dir, or scan workspace for .git folders
        ↓
git log --after/before  →  commits filtered by author + time window
        ↓
group by repo           →  sorted by commit count, most active first
        ↓
render                  →  hash + subject + diff stats + timestamp, one line each
        ↓
--copy (optional)       →  pbcopy / xclip / clip to clipboard

Weekend aware: if today is Monday, morning-git looks at Friday — not Sunday. --days 3 on a Tuesday looks at Thursday of last week, skipping the weekend.

Workspace mode

The most powerful way to use morning-git is with a workspace path. It recursively finds all git repos up to 3 levels deep:

morning-git ~/Sites

  my-api      (main)    ✦  3 commits
  frontend    (dev)     ✦  2 commits
  infra       (main)    ✦  1 commit
  ...

Results are sorted by commit count — most active repo first.

Requirements

| | | |---|---| | Node.js | >= 18 | | Git | Installed and on your PATH | | --copy on Linux | Requires xclip (apt install xclip) |

FAQ

Make sure your git config user.email matches the email on your commits:

git config user.email               # what the tool uses
git log --format="%ae" | sort -u    # emails on your commits

Or use --all to see everyone's commits and confirm yours appear.

Use --days with a larger number. --days 3 on a Monday will go back to the previous Friday and include Saturday/Sunday if you committed then:

morning-git --days 3

Yes — use --all to show commits from everyone:

morning-git ~/Sites --all

• macOS — uses pbcopy (built-in)
• Windows — uses clip (built-in)
• Linux — requires xclip (apt install xclip)

Author

Made by Rakesh Bisht

License

MIT