Skip to content
Worix
BrowsePublish
Log inSign Up

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...

52 downloads
Free
Reviewed

Changelog Generator

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

FlagDescription
--repo PATHPath to git repo (default: cwd)
--since REFStart ref — tag, branch, or commit
--until REFEnd ref (default: HEAD)
--format md|jsonOutput format (default: md)
--groupGroup commits by type
-o FILEWrite to file

Conventional Commit Types

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

Download

ZIP package — ready to use

Skill Info

Creator
Johnnywang2001
Downloads
52
Published
Mar 15, 2026
Updated
Mar 16, 2026