when-do-i-code

Analyze your git history and visualize when you actually write code.

npx when-do-i-code

What it shows

  ◆ when-do-i-code  v1.0.1

  1,234 commits  ·  2022-01-01 → 2026-03-20

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

  COMMITS BY HOUR

  12am  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░     2
   1am  ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░     0
   ...
  10pm  ████████████████████████░░░░░░░░░░░░░░   312  ← peak
  11pm  ██████████████████░░░░░░░░░░░░░░░░░░░░   240

  COMMITS BY DAY OF WEEK

  Mon  ██████████████████████░░░░░░░░░░░░░░░░░   189
  ...
  Sat  ████████████████████████████████████████   342  ← peak

  TIME OF DAY BREAKDOWN

  🌙  Night      00–05  ██░░░░░░░░░░░░░░░░░░░░░░░░░░░░    8% (102)
  🌅  Morning    06–11  ████████░░░░░░░░░░░░░░░░░░░░░░   26% (325)
  🌞  Afternoon  12–17  ████████████████░░░░░░░░░░░░░░   52% (645)
  🌆  Evening    18–23  ██████░░░░░░░░░░░░░░░░░░░░░░░░   18% (162)

Plus a coding personality — are you a Night Owl 🦉, Early Bird 🐦, Day Shifter ☀️, or After-Hours Dev 🌆?

Install

Run without installing:

npx when-do-i-code

Or install globally:

npm install -g when-do-i-code
when-do-i-code

Usage

Usage: when-do-i-code [options]

Options:
  -p, --path <path>      Path to a git repository (skips interactive prompt)
  -a, --author <name>    Filter commits by author name
  -s, --since <date>     Only include commits after this date (e.g. 2023-01-01)
  -u, --until <date>     Only include commits before this date
      --all-authors      Include all authors (default: current git user only)
      --include-merges   Include merge commits
  -V, --version          Output the version number
  -h, --help             Display help

Examples

# Analyze the current directory
npx when-do-i-code

# Analyze a specific repo
npx when-do-i-code --path ~/projects/my-repo

# Clone and analyze a GitHub repo
npx when-do-i-code
# → choose "Enter a GitHub URL" at the prompt

# Last year only
npx when-do-i-code --since 2025-01-01

# All contributors
npx when-do-i-code --all-authors

Requirements

• Node.js >= 14
• Git installed and available in PATH

License

MIT