Changelog Generator

Generate changelogs from git commit history with conventional commit parsing. Use when asked to generate a changelog, create release notes, summarize git his...

Generate clean, professional changelogs from git commit history.

Quick Start

python3 scripts/changelog_gen.py
python3 scripts/changelog_gen.py --since v1.0.0 --group
python3 scripts/changelog_gen.py --since v1.0.0 --until v2.0.0 --format json
python3 scripts/changelog_gen.py --repo /path/to/project --since "2026-01-01" -o CHANGELOG.md

Features

• Conventional commit parsing — auto-detects feat, fix, docs, refactor, perf, test, build, ci, chore, revert
• Breaking change detection — from ! suffix or BREAKING CHANGE in body
• Grouped output — organize by commit type with --group
• Tag ranges — generate changelogs between any two tags or refs
• Dual format — markdown (default) or JSON
• File output — write directly to CHANGELOG.md with -o
• No dependencies — Python stdlib + git

Options

Flag	Description
--repo PATH	Path to git repo (default: cwd)
--since REF	Start ref — tag, branch, or commit
--until REF	End ref (default: HEAD)
--format md|json	Output format (default: md)
--group	Group commits by type
-o FILE	Write to file

Conventional Commit Types

feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert — all parsed automatically.