Git Log — Lost in 5,000 Commits: The PR That Couldn't Be Reviewed

Git log is the most versatile command in Git, but most developers only use git log --oneline. That's like using a search engine with no keywords. Git log supports filtering by author, date range, commit message, file path, and even code content changes. Combined with --format for custom output, it becomes a SQL query engine for your commit history. This guide covers the essential filters, the formatting options that make changelogs write themselves, and the audit incident where 5,000 untagged commits made a security review impossible.

Essential Filters: Author, Date, Message, File, and Pickaxe

git log --author='pattern' filters by author (regex, matches name or email). --after='2024-01-01' --before='2025-01-01' filters by date range. --grep='fix' filters by commit message content. Combining filters narrows rapidly.

git log -S 'string' (pickaxe) finds commits that changed the number of occurrences of a string. This is the most powerful filter — it searches actual code content, not commit messages. -G'regex' finds commits where the patch matches a regex.

git log -- <file> filters to commits touching a specific file. git log --follow -- <file> follows renames. --all searches across all branches, not just the current one.

# Author filter
git log --author='Alice' --oneline

# Date range
git log --after='2024-06-01' --before='2024-12-31' --oneline

# Message filter
git log --grep='fix' --oneline
git log --grep='security' --all --oneline  # across all branches

# File filter
git log --oneline -- src/app.ts
git log --follow --oneline -- src/app.ts  # follows renames

# Pickaxe — search code content
git log -S 'processPayment' --oneline        # string changed
git log -G 'function \w+' --oneline          # regex match

# Combined
git log --author='Bob' --after='2024-01-01' --grep='payment' --oneline

Custom Formatting and Branch Graphs

git log --format='%h %an %s' controls output format. Common placeholders: %h (abbreviated hash), %H (full hash), %an (author name), %ae (author email), %ad (author date), %s (subject), %d (ref decorations).

--graph draws an ASCII branch graph. --decorate shows branch/tag labels. Combined: git log --oneline --graph --decorate --all shows the full repository graph.

--merges shows only merge commits. --no-merges excludes them. --first-parent follows only the first parent of merge commits — useful for seeing the 'main line' of history without feature branch noise.

# Custom format
git log --format='%h %an %ad %s' --date=short

# Pretty graph view
git log --oneline --graph --decorate --all

# Only merge commits
git log --merges --oneline

# Skip merge commits
git log --no-merges --oneline

# First parent only (main line)
git log --first-parent --oneline

# Show commits with full diff
git log -p -2  # last 2 commits with full diff

# Shortlog (summary by author, like release notes)
git shortlog -sn  # commits per author, sorted

# Stats summary
git log --stat --oneline -5